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PREFACE 



This manual describes the CP-V features that are designed to aid the system programmer in the development 
maintenance, and modification at the CP-V system. 

Manuals describing other features of CP-V are outlined below: 

• The CP-rV System Management Reference Manual, 90 16 74, is the principal source of reference informa- 
tion for the system management features of CP-V. It defines the rules for generating a CP^V system 
(SYSGEN), authorizing users, maintaining user accounting records, maintaining the file system, monitor- 
ing system performance, and other related functions. 

• The CP-V Batch Reference Manual, 90 17 64, is the principal source of reference information for the batch 
processing features of C P-V (i.e., job control commands, system procedures, I/O procedures, program 
loading and execution, debugging aids, and service processors). 

• The CP-V Time-Sharing Reference Manual, 90 09 07, is the principal source of information for the time- 
sharing features of C P-V. It defines the rules for using the Terminal Executive Language and other 
terminal processors. 

• The CP-V Time-Sharing User's Guide, 90 16 92, describes how to use the various time-sharing features. 
It presents an introductory subset of the features in a format that allows the user to learn the material by 
using the features at a terminal as he reads through the document. 

• The CP-V Remote Processing Reference Manual, 90 30 26, is the principal source of information about the 
remote processing features of CP-V. All information about remote processing for all computer personnel 
(remote and local users, system managers, remote site operators, and central site operators) is included in 
the manual. 

• The CP-V Transaction Processing Reference Manual, 90 31 12, provides information about dynamically 
modifying and querying a central database in a transaction processing environment. The manual is addressed 
to system managers, database administrators, applications programmers, and computer operators. 

• The CP-V Operations Reference Manual, 90 16 75, is the principal source of reference information for 

-. CP-V computer operators. It defines the rules for operator communication (i.e., key-ins and messages), 
system start-up and initialization, job and system control, peripheral device handling, recovery and file 
preservation. 

• The CP-V Common Index (90 30 80) is an index to all of the above CP-V manuals. 

Information for the language and application processors that operate under CP-V is also described in separate man- 
uals. These manuals are listed on the Related Publications page of this manual. 



COMMAND SYNTAX NOTATION 



Notation conventions used in command specifications and examples throughout this manual are listed below. 



Notation 


Description 


lowercase letters 


Lowercase letters identify an element that must be replaced with a 
user-selected value. 




CRndd could be entered as CRA03. 


CAPITAL LETTERS 


Capital letters must be entered as shown for input, and will be printed as 
shown in output. 




DPndd means "enter DP followed by the values for ndd". 


[3 


An element inside brackets is optional. Several elements placed one under 
the other inside a pair of brackets means that the user may select any one or 
none of those elements. 




[KEYM] means the term "KEYM" may be entered. 


{] 


Elements placed one under the other inside a pair of braces identify a re- 
quired choice. 




j . , | means that either the letter A or the value of id must be entered. 


... 


The horizontal ellipsis indicates that a previous bracketed element may be 
repeated, or that elements have been omitted. 




namef, name]. . . means that one or more name values may be 
entered, with a comma inserted between each name value. 




The vertical ellipsis indicates that commands or instructions have been 
omitted. 




MASK2 DATA,2 X'lEF' 

'. means that there are one or more state - 

„. /Tr ^nata o r»A/i /cr>\\ ments omitted between the two DATA 
BYTE DATA, 3 BA(L(59)) .. 

directives. 


Numbers and 
special characters 


Numbers that appear on the line (i.e. , not subscripts), special symbols, and 
punctuation marks other than dotted lines, brackets, braces, and underlines 
appear as shown in output messages and must be entered as shown when input. 




(value) means that the proper value must be entered enclosed in 
parentheses; e.g., (234). 


Subscripts 


Subscripts indicate a first, second, etc. , representation of a parameter that 
has a different value for each occurrence. 




sys?d],sysid2/Sysid3 means that three successive values for sysid 
should be entered, separated by commas. 


Superscripts 


Superscripts indicate shift keys to be used in combination with terminal keys, 
c is control shift, and s is case shift. 




L cs means press the control and case shift (CONTROL and SHIFT) and 
the L key. 


Underscore 


All terminal output is underscored; terminal input is not. 




!RUN means that the exclamation point was sent to the terminal, but 
RUN was typed by the terminal user. 


©@© 


These symbols indicate that an ESC (@), carriage return (@), or line feed 
(©) character has been sent. 




IEDIT © means that, after typing EDIT, a carriage return character 
nas been sent. 



GLOSSARY 



ANS tape a tape that has labels written in American 

National Standard (ANS) format. 

batch job a job that is submitted to the batch job stream 
through the central site card reader, through an on-line 
terminal (using the Batch processor), or through a re- 
mote terminal. 

binary input input from the device to which 4he BI 

(binary input) operational label is assigned. 

concatenation a process whereby a number of files with 
the same filename and format are treated as one logical 
file. Concatenation is only applicable to ANS tapes. 

conflicting reference a reference to a symbolic name 
that has more than one definition. 

control command any control message other than a key-in. 
A control command may be input via any device 
to which the system command input function has been 
assigned (normally a card reader). 

control message any message received by the monitor 
that is either a control command or a control key-in. 

cooperative a monitor routine that transfers information 
between a user's program and disk storage (also see 
"symbiont"). 

data control block (DCB) a table in the user's program 
that contains the information used by the monitor in 
the performance of an I/O operation. 

external reference a reference to a declared symbolic 
name that is not defined within the object module in 
which the reference occurs. An external reference 
can be satisfied only if the referenced name is de- 
fined by an external load item in another object 
module. 

file extension a convention that is used when certain 
system output DCBs are opened. Use of this conven- 
tion causes the file (on RAD, tape, disk pack, etc.) 
connected to the DCB to be positioned to a point just 
following the last record in the file. When additional 
output is produced through the DCB, it is added to the 
previous contents of the file, thereby extending the 
file. 

function parameter table (FPT) a table through which a 
user's program communicates with a monitor function 
(such as an I/O function). 

ghost job a job that is neither a batch nor an on-line 
program. It is initiated and logged on by the monitor, 
the operator, or another job and consists of a single 
job step. When the ghost program exits, the ghost is 
logged off. 



global symbol a symbolic name that is defined in one 

program module and referenced in another. 

. . ■ . . f 

GO file a temporary disk storage file consisting of re*r 

locatabie object modules formed by a processor. 

granule a block of disk sectors large enough to contain 
512 words (a page) of stored information. 

job information table (JIT) a table associated with each 
active job. The table contains accounting, memory 
mapping, swapping, terminal DCB(M:UC), and tempos 
rary monitor information. 

job step a subunit of job processing such as compilation, 
assembly, loading, or execution. Information from cer- 
tain commands (JOB, LIMIT, and ASSIGN) and all 
temporary files created during a job step are carried 
from one job step to the next but the steps are otherwise 
independent. 

key a data item consisting of 1-31 alphanumeric char- 
acters that uniquely identifies a record. 

key-in information entered by the operator via a 

keyboard. 

language processor a program that translates a user's 
source language program into an object language 
program. 

library load module a load module that maybe combined 
with relocatable object modules, or other library load 
modules, to form a new executable load module. 

linking loader a program that is capable of linking and 
loading one or more relocatable object modules and 
load modules. 

load map a listing of loader output showing the location 
or value of all global symbols entering into the load. 
Also shown are symbols that are not defined or have 
multiple definitions. 

load module (LM) an executable program formed by the 
linking loader, using relocatable object modules 
(ROMs) and/or modules (LMs) as input information. 

logical device a peripheral device that is represented 
in a program by an operational label (e.g., BI or PO) 
rather than by specific physical device name. 

logical device stream an information stream that may 

be used when performing input from or output to a sym- 
biont device. At SYSGEN, up to 15 logical device 
streams are defined. Each logical device stream is 
given a name (e.g., LI, PI, CI), each is assigned to 
a default physical device, and each is given default 
attributes. The user may perform I/O through a logical 
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• device stream with the default physical device and 
attributes or he may change the physical device and/or 
attributes, to satisfy the requirements of his job. 

monitor a program that supervises the processing, load- 

ing, and execution of other programs. 

object language the standard binary language in which 

the output of a language processor is expressed. 

object module the series of records containing the load in- 

formation pertaining to a singleprogram or subprogram * 
(i.e., from the beginning to the end). Object modules 
serve as input to the Load processor or Link processor. 

on-line job a job that is submitted through an on-line 

terminal by a command other than the BATCH command. 

operational label a symbolic name used to identify a 

logical system device. 

overlay loader a monitor routine that loads and links 

elements of overlay programs. 

overlay program a segmented program in which the ele- 

ment (i.e., segment) currently being executed may 
overlay the core storage area occupied by a previously 
executed element. , 
I 

patch a symbolic representation of a correction to the 

system that is used to temporarily correct the system 
without necessitating a reassembly. 

physical device a peripheral device that is referred to 

by a name specifying the device type, I/O channel, 
and device number (also see "logical device"). 

program product a compiler or application program that 

has been or will be released by Xerox, but is not re- 
quired by all users and is therefore made available by 
Xerox on an optional basis. Program products are pro- 
vided only to those users who execute a License Agree- 
ment for each applicable installation. 

prompt character a character that is sent to the terminal 

by an on-line processor to indicate that the next line 
of input may be entered. 

protective mode a mode of tape protection in which only 

ANS expired tapes may be written on through an AN5 
DCB; no unexpired ANS tape maybe written on through 
a non-ANS DCB; all ANS tapes must be initialized by 
the Label processor; no tape serial number specification 
is allowed at the operator's console; specification of an 
output serial number in an ANS DCB forces processing 
to be done only on a tape already having that serial 
number; tapes mounted as IN may not be written; and 
tapes mounted as other than IN must have a write ring. 
(See "semiprotecfive mode". ) 

public library a set of library routines declared at 

SYSGEN to be public (i.e., to be used in common by 
all concurrent users). 



reentrant an attribute of a program that allows the 

program to be shared by several users concurrently. 
Shared processors in CP-Y are reentrant. That is, each 
instance of execution of the single copy of the pro- 
gram's instructions has a separately mapped copy of the 
execution data. 

relative allocation - ; allocation of virtual memory to a 
user program starting with the first unallocated page 
available. 

relocatable object module (ROM) a program or subpro- 

gram in object language generated by a processor such 
asMeta-Symbol or FORTRAN. 

remote processing an extension of the symbiont system 

that provides flexible communication between CP-V 
and a variety of remote terminals. 

resident program a program that has been loaded into a 

dedicated area of core memory. 

response time the time between the completion of termi- 

nal input and the first program activation. 

scheduler a monitor routine that controls the initiation 
and termination of all jobs, job steps, and time slice 
quanta. 

secondary storage any rapid-access storage medium other 

than core memory (e.g., RAD storage). 

semi-protective mode a mode of tape protection in which 

a warning is posted to the operator when an ANS DCBg 
attempts output on a non-ANS tape or an unexpired Af^ 
tape, when a non-ANS DCB attempts output on an un- 
expired ANS tape, or when a tape mounted as IN OUT 
has no write ring. The operator can authorize the over- 
writing of the tape or the override of INOUT through a 
key-in (OVER and READ). ANS tapes may be ini- 
tialized by the Label processor or may be given labels 
as the result of an operator key-in; tape serial number 
specification is allowed at the operator's console; and 
specification of an output serial number in an ANS 
DCB forces processing to be done only on a tape al- 
ready having that serial number unless the operator 
authorizes an overwrite. (See "protective mode". ) 

shared processor a program (e.g., FORTRAN) that is 

shared by all concurrent users. Shared processors must 
be established during SYSGEN or via DRSP. 

source language a language used to prepare a source 
program suitable for processing by an assembler or 
compiler. 

special shared processor a shared processor that may be 

in core memory concurrently with the user's program 
(e.g., Delta, TEL, or the FORTRAN library). 

specific allocation allocation of a specific page of 

unallocated virtual memory to a user program. 



SRI, SR2, SR3, and SR4 see "system register", below. 

static core module a program module that is in core 
memory but is nor being executed. 

stream-id the name of a logical device stream. 

symbiont a monitor routine that transfers ^formation 
between disk storage and a peripheral device inde- 
pendent of and concurrent with job processing. 

symbolic input input from the device to which the SI 

(symbolic input) operational label is assigned. 

symbolic name an identifier that is associated with 
some particular source program statement or item so 
that symbolic references maybe made to it even though 
its value may be subject to redefinition. 

SYSGEN see "system generation", below. 

system generation (SYSGEN) the process of creating an 
operating system that is tailored to the specific require- 
ments of an installation. The major SYSGEN steps 



include: gathering the relevant programs, generating 
specific monitor tables, loading monitor and system 
processors, and writing a bootable system tape. 

system library a group of standard routines in object- 
language format, any of which may be incorporated in 
a program being formed. 

system register a register used by the monitor to commu- 
nicate information that may be of use to the user pro- 
gram (e.g., error codes). System registers SRI, SR2, 
SR3, and SR4 are current general registers 8, 9, 10, 
and 11, respectively. 

task control block (TCB) a table of program control in- 
formation built by the loader when a load module is 
formed. The TCB is part of the load module and con- 
tains the data required to allow reentry of library rou- 
tines during program execution or to allow entry to the 
program in cases of traps, breaks, etc. The TCB is 
program associated and not task associated . 

unsatisfied reference a symbolic name that has been ref- 
erenced but not defined. 
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1. INTRODUCTION 



CP-V SERVICES 

Control Program-Five (CP-V) is a comprehensive operating 
system designed for use with Sigma 6/7/9 and Xerox 560 
'computers and a variety of peripheral equipment. CP-V 
offers : 

• On-line time-sharing, batch processing, remote pro- 
cessing, transaction processing, and real-time services. 



Ability to handle a large number' of concurrent users. 

High efficiency due to hardware relocation map, 
shared reentrant processors, multiple I/O processors, 
and device pooling. 



• A complete recovery system coupled with preservation 
of user files to provide fast restart following hardware 
or software malfunction. 



• For on-line users: highly efficient and extensive soft- 
ware, file saving feature, fast response time. 



• For batch users: on-line, local, and remote entry to 
an efficient multiprogramming batch job scheduler. 



For installation managers: thorough system monitoring 
and reporting, control and tuning ability, extensive 
error checking and recovery features. 



For all users: comprehensive accounting and a com- 
plete set of powerful processors. 



TIMESHARING AND BATCH PROCESSING 

CP-V allows multiple on-line terminal users to concurrently 
create, debug, and execute programs. Concurrent to time- 
sharing, CP-V allows up to 16 batch processing jobs to 
execute in its multiprogramming environment. An efficient 
multi-batch scheduler selects batch jobs for execution 
according to priority, job requirements, and availability of 
resources. Batch jobs may be submitted to this scheduler 
from a local batch entry device such as a card reader, from 
an on-line user's terminal, or from a remote site such as a 
remote batch terminal or another computer. 

Time-sharing and batch users have access to a variety 
of powerful and comprehensive language processors and 
facilities. These processors and facilities are listed 
below. 



Processor 
TEL 

EASY 
Edit 

FORTRAN IV 

COBOL 
Meta-Symbol 

BASIC 

A PL 
FLAG 
FDP 
Delta 



COBOL On-line 
Debugger 

PCL 



Link 

LYNX 

Load 

Batch 

Manage 
SL-1 

CIRC 



' Function 

Executive language control of all 
terminal activities. (On-line only.) 

Creation, manipulation, and execution 
of FORTRAN and BASIC programs and 
data files. (On-line only.) 

Composition and modification of pro- 
grams and other bodies of text. (On- 
line only.) 

Compilation of Extended FORTRAN IV 
programs. 

Compilation of ANS COBOL programs. 

Assembly of high-level assembly lan- 
guage programs. 

Compilation and execution of programs 
or direct statements written in an ex- 
tended BASIC language. 

Interpretation and execution of pro- 
grams written in the APL language. 

Compilation of fast "load-and-go" 
FORTRAN programs. 

Debugging of Extended FORTRAN IV 
programs. 

Debugging of programs at the assembly 
language level . (On-line only.) 

Debugging of ANS COBOL programs. 
(On-line only. ) 

Transfer (and conversion) of data be- 
tween peripheral devices. 

Linkage of programs for execution. 

Linkage of programs for execution. 

Linkage of programs for execution 
(Batch only.) 

Submission of batch jobs via an on- 
line terminal or another batch job. 

File retrieval, updating, and reporting. 

Compilation of programs written in a 
language designed specifically for 
digital or hybrid simulation. 

Analysis of electronic circuits. 
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Processor Function 

LEMUR' Construction and manipulation of 

unsnared libraries 

EDMS Organization, storing, updating, and 

deletion of information in a centralized 
data base. 

Sort/Merge Sorting and/or merging of records in 

one or more files. 



longer required. Users may also request that a mapped 
program be held in core in order to reduce the time required 
to respond to an external event (via an interrupt) or to 
allow various forms of special I/O to occur. Programs may 
be connected to one of the monitor's clocks such that after 
a specified period of time, a specified routine is entered. 
In addition, dedicated foreground memory may be used as 
inter-program communication buffers or as dedicated memory 
for unmapped, master mode programs which may be directly 
connected to external interrupts or real-time clocks. 



GPDS Experimentation with and evaluation of 

system methods, processes, and designs. 
(Batch only.) 

REMOTE PROCESSING 

The remote processing system is an extension of the CP-V 
symbiont system. Its purpose is to provide for flexible com- 
munication between CP-V and a variety of remote terminals. 
These terminals can range from a simple card reader, card 
punch, and line printer combination to another computer 
system with a widevarietyof peripheral devices. AnyCP-V 
user (batch, on-line, ghost) can communicate with any 
number of devices at one or several remote sites. Because 
CP-V can act as a central site to some remote sites and 
simultaneously as a remote terminal to other computers, 
the remote processing facilities encourage the construction 
of communication networks. 



TRANSACTION PROCESSING 

The transaction processing feature of CP-V is an efficient 
and economical approach to centralized information pro- 
cessing and is a generalized package that is designed to 
meet the requirements of a variety of business applications. 
Transaction processing facilities provide an environment in 
which several users at remote terminals may enter business 
transactions, simultaneously utilizing a common data base. 
The transactions are processed immediately, as they are 
received, by application programs written especially for 
the particular installation. As necessary, reports may 
then be created and sent to an appropriate terminal. 



REAL-TIME PROCESSING 

The real-time services provided by CP-V allow users to 
connect interrupts to mapped programs, control the state of 
interrupts (e.g., trigger, arm/disarm, enable/disable), 
clear interrupts either at the time of occurrence or upon 
completion of processing, and disconnect interrupts no 



SYSTEM PROGRAMMING FACILITIES 

This manual describes the CP-V features that are designed 
to aid the system programmer in the development, main- 
tenance, and modification of the CP-V system. The facil- 
ities described in this manual aid the system programmer 
in the following areas: 

• Modification of the CP-V operating system at the 
instruction level at boot-time. 

• Reconfiguration of peripheral devices at boot-time. 

• Analysis of crash dumps to determine the cause of a 
system crash. 

• Creation and modification of the error message file 
for the CP-V monitor overlays while the system is 
operational. 

• Listing and analysis of hardware and software mal- 
functions occurring during system operation. 

• Development of shared processors such as compilers, 
assemblers, command language processors, and 
debuggers. 

• Replacement, creation, and deletion of shared pro- 
cessors and monitor overlays while the system is 
operational. 

• Development of peripheral hardware diagnostic 
programs. 

• Development of real-time programs. 

• Support of transaction processing facilities. 

• Implementation of remote diagnostics for the Xerox 560. 



System Programming Facilities 
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2. SYSTEM OVERVIEW 



INTRODUCTION 



COMMAND PROCESSORS 



The CP-V operating system consists of a monitor and a 
number of associated processors (Figure 1). The monitor 
provides overall supervision of program processing. The 
associated processors provide specific functions such as 
compilation, execution, and debugging. 



The four processors in this group are: LOGON/LOGOFF, 
EASY, TEL, and "CO.' The first of these processors is avail- 
able to on-line and batch users, the second and third are 
available to on-line users only, and the last is available to 
batch users only. 



PROCESSORS 

The CP-V system is illustrated in Figure 1 at two levels. The 
upper level lists the various monitor routines. The lower 
level lists the various processors. The processors are de- 
scribed in the following paragraphs. 



LOGON/LOGOFF 

LOGON admits on-line users to the system and connects 
the user's terminal either to TEL or to an alternative pro- 
cessor, such as BASIC, that has been selected by the user. 
LOGOFF disconnects a user from the system and does the 
final cleanup and accounting. 



Commend 
Processors 



LOGON/ 

LOGOFF (OB) 
TEL(0) 
EASY (O) 
CCI (B) 



Monitor 



Basic Control 
Scheduling and Swapping 
Memory Management 
Job Step Control 
Terminal I/O 

Symbionts and Cooperatives 
File Management 



System Integrity 

Initialization and Start-Up 

Operator Communication 

Batch Debugging 

System Debugging 

Load and Link 

Public and System Libraries 



System 

Management 

Processors 



Super (OBG) 
Control (OBG) 
Rates (O) 
FILL (OG) 
FSAVE (OB) 
FRES (OB) 
Fix (OBG) 
VOLINIT(OBGS) 
Label (B) 
STATS (OBG) 
Summary (OB) 
SYSCON (OG) 
GAC (OBG) 
DEVDMP (S) 
ONLIST (OBG) 
PPS (G) 



Language 
Processors 



FORTRAN IV (OB) 
Meta -Symbol (OB) 
AP (OB) 
BASIC (OB) 
FLAG (OB) 
ANS COBOL (OB) 
APL (OB) 
RPG (B) 
SL-1 (OB) f 



Execution 

Control 

Processors 



Link (OB) 
Load (B) 
LYNX (OB) 
Delta (O) 
FDP (OB) 
COBOL 

On-Line 

Debugger (O) 
GENMD (OBG) 



Service 
Processors 



Edit (OG) 
PCL (OB) 
SYSGEN (OB) 
DEFCOM (OB) 
SYMCON (OB) 
ANLZ (OBG) 
Batch (OBG) 
DRSP (OB) 
ELLA (OBG) 
Show (OB) 
LEMUR (OB) 



Application 
Processors 



Sort/Merge (B) 
EDMS (B) f 
GPDS (B) f 
CIRC (OB) f 
Manage (OB) f 
Transaction Pro- 
cessing (OB) 



User Processors 



(OBG) 



Note: O on-line 

B batch 

G ghost 

S stand-alone 



Program product (see glossary). 



Figure 1. CP-V Operating System 
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System Overview 



EASY 

EASY is a shared processor that enables the user to create, 
edit, execute, save, and delete program files written in 
BASIC or FORTRAN. EASY also allows the user to create 
and manipulate EBCDIC data files. Although intended pri- 
marily for Teletype® operations, EASY can be used with 
any type of on-line terminal supported by the system. 
(Reference: EASY/LN,OPS Reference Manual, 90 18 73. ) 



TERMINAL EXECUTIVE LANGUAGE 

TEL is the. default command processor for time-sharing and 
serves as the terminal user's interface to the various services 
of CP-V. TEL is functionally equivalent to the batch mode 
Control Command Interpreter. Some of the functions per- 
formed by TEL are: 

1. Calling user programs and system processors. 

2. Changing the log -on password. 

3. Assigning I/O devices and DCB parameters. 

4. Requesting extended memory mode. 

5. Determining on-line user status. 

6. Changing terminal platen size. 

7. Sending messages to the operator. 

8. Logging off. 

CONTROL COMMAND INTERPRETER 

The Control Command Interpreter is the batch counterpart 
of TEL. It provides the batch user with control over the 
processing of batch programs just as TEL provides on-line 
users with control over the processing of on-line programs. 
(Reference: CP-V/BP Reference Manual, 90 17 64.) 



individually authorize or deny access to the various processors 
for each user. Super is aiso used to create and delete remote 
processing Vvorkstations. (Reference: CP-V/SM Reference 
Manual, 90 16 74.) 



CONTROL 

The Control processor provides control over system perfor- 
mance. CP-V has a number of performance measurements 
built directly into the system. Commands of the Control 
processor enable the system manager to display these mea- 
surements and to "tune" the system as needed by setting new 
values for the parameters that control system performance. 
(Reference: CP-V/SM Reference Manual, 90 16 74.) 



RATES 

The Rates processor allows the system manager to set relative 
charge weights on the utilization of system services. 

Specific items to which charge weights may be assigned 
include 

1. CPU time. 

2. CPU time multiplied by core size. 

3. Terminal interactions. 

4. I/O CALs. 

5. Console minutes. 

6. Tapes and packs mounted. 

7. Page -date storage. 

8. Peripheral I/O cards plus pages. 

(Reference: CP-V/SM Reference Manual, 90 16 74.) 



SYSTEM MANAGEMENT PROCESSORS 

System management processors furnish the manager of a 
CP-V installation with on-line control of the system. Four- 
teen system management processors are supplied. 



FIX 



The Fix processor enables the system manager to repair or 
delete damaged file directories. It also provides HGP 
reconstruction for private disk pack sets and the public 
file system. (Reference: CP-V/OPS Reference Man- 
ual, 90 16 75.) 



SUPER 

Super gives the system manager control over the entry of 
users and the privileges extended to users. Through the use 
of Super commands, the system manager may add and delete 
users, specify how much core and disk storage space a 
user will have, specify how many central site magnetic 
tape units a user will have, grant certain users, such as 
system programmers, special privileges, (e.g., the privilege 
of examining, accessing, and changing the monitor), and 
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FILL 

The FILL processor performs three basic file maintenance 
functions: 

1. It copies files from disk to tape as a backup. 

2. It restores files from tape to disk. 

3. It deletes files from disk. 

(Reference: CP-V/OPS Reference Manual, 90 16 75. ) 



4 Processors 



FSAVE 



GRANULE ACCOUNTING CLEANUP PROCESSOR (GAC) 



The Fast Save (FSAVE) processor is designed to save disk 
files on tape at or near tape speed. The processor is faster 
than any other file saving procedure under CP-V. (Ref- 
erence: CP-V/OPS Reference Manual, 90 16 75.) 



FRES 



The File Restore (FRES) processor is designed to restore to 
disk files that were saved on tape by FSAVE or Fill. (Ref- 
erence: CP-V/OPS Reference Manual, 90 16 75.) 



VOLINIT 

VOLINIT provides for the initialization of public and pri- 
vate disk packs. It is used to establish serial numbers and 
ownership, to write headers and other system information in 
selected areas of the volumes, and to test the surface 
of the disks and select alternate tracks to be used in 
place of flawed tracks. (Reference: CP-V/OPS Reference 
Manual, 90 16 75. ) 



LABEL 



The Granule Accounting Cleanup (GAC) processor correlates 
information between the file DISKPOOL and the account 
authorization file, :USERS. DISKPOOL Is created by the 
FSAVE processor and contains specific account information. 
Each account record in DISKPOOL contains an entry for 
accumulated public disk pack granules and an entry for ac- 
cumulated RAD granules. When GAC is run, these accumu- 
lated values are compared against the maximum values for 
the corresponding accounts in the :USERS file and the user's 
entry in the :USERS file is updated to reflect the latest 
accumulated values for RAD and disk. When the accumu- 
lated RAD or disk granules exceed the corresponding maxi- 
mum values, this fact is noted in the report that is produced 
by the GAC processor. (Reference: CP-V/OPS Reference 
Manual, 90 16 75. ) 



DEVDMP 

The Device Save/Restore processor (DEVDMP) is a stand- 
alone utility program designed to dump entire disk volumes 
to magnetic tapes for restoration at a later time. Restora- 
tion may only be made to an identical storage unit. (Ref- 
erence: CP-V/OPS Reference Manual, 90 16 75.) 



The Label processor initializes ANS tapes by writing ANS 
formatted labels. It may also be used to create "unlabeled" 
tapes from new tapes to be used as scratch tapes and to 
print the contents of the header and trailer labels of 
labeled tapes or the first 80 bytes of each block on un- 
labeled tapes. (Reference: CP-V/OPS Reference Man- 
ual, 90 16 75. ) 



LANGUAGE PROCESSORS 

Language processors translate high-level source code into 
machine ob}ect code. Eight processors of special importance 
are described below. All of these can be used in both on- 
line and batch mode. 



STATS 

The STATS processor displays and collects performance data 
on a running system and produces snapshot files to be dis- 
played by the report generator Summary. (Reference: 
CP-V/SM Reference Manual, 90 16 74.) 



SUMMARY 

The Summary processor provides a global view of system 
performance by formatting and displaying the statistical 
data collected by STATS. (Reference: CP-V/SM Reference 
Manual, 90 16 74.) 



XEROX EXTENDED FORTRAN IV 

The Xerox Extended FORTRAN IV language processor con- 
sists of a comprehensive algebraic programming language, a 
compiler, and a large library of subroutines. The language 
is a superset of most available FORTRAN languages, con- 
taining many extended language features to facilitate pro- 
gram development and checkout. The compiler is designed 
to produce efficient object code, thus reducing execu- 
tion time and core requirements, and to generate extensive 
diagnostics to reduce debugging time. The library contains 
over 235 subprograms and is available in a reentrant ver- 
sion. Both the compiler and run-time library are reentrant 
programs that are shared among all concurrent users to re- 
duce the utilization of critical core resources. 



SYSCON 

SYSCON is a system control processor that can be used to 
partition resources from the system, to return resources to 
the system, and to display the status of the various system 
resources. SYSCON can also be used to build, update, or 
display the M:MODNUM file, a file which contains device 
and controller model numbers. (Reference: CP-V/SM Ref- 
erence Manual, 90 16 74.) 



The principal features of Xerox Extended FORTRAN IV are 
as follows: 

• Extended language features to reduce programming 
effort and increase range of applications. 

• Extensive meaningful diagnostics to minimize debug- 
ging time. 



Processors 



• In-line symbolic code to reduce execution time of 
critical parts of the program. 

« Overlay organization for minimal core memory 
utilization. 

Compiler produced reentrant programs. 

(Reference: Extended FORTRAN IV/LN Reference Man- 
ual, 90 09 56, and"Extended FORTRAN IV/OPS Reference 
Manual, 90 11 43. ) . 



META -SYMBOL 

Meta-Symbol is a procedure-oriented macro assembler. It 
has services that are available only in sophisticated macro 
assemblers and a number of special features designed to 
permit the user to exercise dynamic control over the para- 
metric environment of assembly. It provides users with a 
highly flexible language with which to make full use of 
the available hardware capabilities. 

Meta-Symbol may be used in either batch or on-line mode. 
When used in on-line mode, the assembler allows programs 
to be assembled and executed on-line but does not allow 
conversational interaction. 

One of the many Meta-Synfibol features is a highly flexible 
list definition and manipulation capability. In Meta- 
Symbol, lists and list elements may be conveniently rede- 
fined, thus changing the value of a given element. 

Another Meta-Symbol feature is the macro capability. 
Xerox uses the term "procedure" to emphasize the highly 
sophisticated and flexible nature of its macro capability. 
Procedures are assembly-time subroutines that provide the 
user with an extensive function capability. Procedure def- 
inition, references, and recursions may be nested up to 
32 levels. 

Meta-Symbol has an extensive set of operators to facilitate 
the use of logical and arithmetic expressions. These opera- 
tors facilitate the parametric coding capabilities available 
with Meta-Symbol (parametric programming allows for dy- 
namic specification of both "if" and "how" a given state- 
ment or set of statements is to be assembled). 

Meta-Symbol users are provided with an extensive set of 
directives. These directives, which are commands intrinsic 
to the assembly, fall into three classes: 

1. Directives that involve manipulation of symbols and 
are not conditionally executed. 

2. Directives that allow parametric programming. 

3. Directives that do not allow parametric programming. 

A number of intrinsic functions are also included in Meta- 
Symbol. These give the user the ability to obtain informa- 
tion on both the structure and content of an assembly time 
construct. For example, the user can acquire information 



on the' length of a certain list; " He can inquire about a 
specific symbol and whether it occurs in a procedure refer- 
ence. (Reference: Mefa-Symbol/LN, OPS Reference Man- 
ual, 90 09 52.) 



AP 



Assembly Program (AP) is or four-phase assembler that reads 
source language programs and converts them to object lan- 
guage programs. AP outputs the object language program, 
an assembly listing, and a cross reference (or concordance) 
listing. AP is available in both the on-line and batch 
modes. 

The following list summarizes AP's more important features 
for the programmer: 

• Self-defining constants that facilitate use of hexa- 
decimal, decimal, octal, floating-point, scaled fixed- 
point, and text string values. 

• The facility for writing large programs in segments 
or modules. The assembler will provide information 
necessary for the loader to complete the linkage be- 
tween modules when they are loaded into memory. 

• The label, command, and argument fields may contain 
both arithmetic and logical expressions, using constant 
or variable quantities. 

• Full use of lists and subscripted elements is provided. 

• The DO, DOl, and GOTO directives allow selective 
generation of areas of code, with parametric constants 
or expressions evaluated at assembly time. 

• Command procedures allow the capability of generating 
many units of code for a given procedure call line. 

• Function procedures return values to the procedure call 
line. They also provide the capability of generating 
many units of code for a given procedure call line. 

• Individual parameters on a procedure call line can be 
tested both arithmetically and logically. 

• Procedures may call other procedures, and may call 
procedures recursively. 

BASIC 

BASIC is a compiler and programming language based on 
Dartmouth BASIC. It is, by design, easy to teach, learn, 
and use. It allows individuals with little or no programming 
experience to create, debug, and execute programs via an 
on-line terminal. Such programs are usually small tomedium 
size applications of a computational nature. 

BASIC is designed primarily for on-line program development 
and execution, or on-line development and batch execu- 
tion. In addition, programs may be developed and executed 
in batch mode. 
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BASIC provides two user modes of operation. The editing 
mode is Used for creating and modifying programs. The 
compilation/execution mode is used for running completed 
programs. This arrangement simplifies and speeds up the 
program development cycle. 

Statements may be entered via a, terminal and immediately 
executed. The principal benefit of direct execution is on- 
line development of programs and short simple computations. 
During execution, programs may be investigated for loop 
detection, snapshots of variables may be obtained, values 
of variables may be changed, flow of execution may be re- 
routed, and so on. This unique capability allows an on- 
line terminal to be used as a "super" desk calculator. 

At compile and execute time, the user may specify if an 
array dimension check is to be made. In the safe mode, 
statements are checked to verify that they do not reference 
an array beyond its dimensions. In the fast mode, this 
time consuming check is not made. Thus, the safe mode 
could be used during checkout, and the fast mode could be 
used to speed up execution when the program reaches the 
production stage. 



The FLAG debug mode is a user-selected option that gener- 
ates extra instructions in the compiled program to enable 
the user, during program execution, to detect errors in pro- 
gram logic that might .otherwise go undetected or cause un- 
explainable program failure. (Reference: FLAG/Reference 
Manual, 90 16 54.) 



ANS COBOL 

The Xerox ANS COBOL compiler offers the user a powerful 
and convenient programming language facility for the im- 
plementation of business or commerical applications. The 
language specifications fully conform to the proposed ANSI 
standard for the various functional processing modules. 
Only those language elements that cause ambiguities or are 
seldom used have been deleted. The compiler's design 
takes full advantage of the machine's unique hardware 
features, resulting in rapid compilation of source code, 
rapid execution of the resulting object code, and the gen- 
eration of compact programs. The result is a highly efficient 
programming system requiring a minimum amount of storage. 



BASIC provides an image statement that uses a "picture" of 
the desired output format to perform editing. It also has 
TAB capability and a precision option to indicate the num- 
ber of significant digits (6 or 16) to be printed. 

An easy-to-use feature is provided to allow the user to read, 
write, and compare variable alphanumeric data. This is 
particularly important for conversational input processing. 



Xerox ANS COBOL contains many facilities that are either 
not found in other systems or, if available, are provided 
only at greater cost in terms of equipment required. Some 
of the facilities that provide more flexibility and ease of 
use in program development include 



1. Implementation of table handling mode. 



Chaining permits one BASIC program to call upon another 
for compilation and execution without user intervention. 
Thus, programs that would exceed user core space may be 
segmented, and overlay techniques may be employed via 
the chaining facility. (Reference: BASIC/Reference Man- 
ual, 90 15 46.) 



2. Sort/merge linkage. 



3. Sequential access. 



4. Random access linkage. 



FLAG 

FLAG (FORTRAN Load and Go) is an iii-core FORTRAN 
compiler that is compatible with the FORTRAN IV-H class 
of compilers. It can be used in preference to the other 
FORTRAN compilers when users are in the debugging phase 
of program development. FLAG is a one-pass compiler and 
uses the Extended FORTRAN IV library. Included in the 
basic external functions are the Boolean functions IAND 
(AND), IEOR (exclusive OR), and IOR (OR), which give 
the FORTRAN user a bit manipulation capability. 



5. Segmentation. 



6. Report writer. 



7. Library utilization. 



8. Calling sequence for FORTRAN, Meta-Symbol, etc. 



If several FLAG jobs are to be run sequentially, they may 
be run in a sub-job mode, thus saving processing time nor- 
mally needed for the Control Command Interpreter (CO) to 
interpret the associated control cards. In this mode, 
FLAG will successively compile and execute any number 
of separate programs, thereby reducing monitor overhead. 



9. Packed decimal as well as floating-point arithmetic 
formats. 



10. Data name series options for ADD, SUBTRACT, MUL- 
TIPLY, DIVIDE, and COMPUTE verbs. 
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The system provides the user with a comprehensive se-t of 
aids k> minimize the time required to print "bug-free" pro- 
grams In jlv&jbrm of listings. These listings include ' 



.1. The source, language Input to the compiler wifh inter- 
spersed English Jangyage diagnostic messages. . - 



2, An optional listing of the -e'ocatable binary output, 
printed in line number sequence identical to the source 
language listing. 



3. A cross-reference listing, indicating by line number 
where each data name or paragraph name is defined in 
the COBOL program and where each reference is 
located. 



In addition, at run time, the user may use TRACE and 
EXHIBIT to follow execution of the procedure division. 



The compiler is designed to take full advantage of high- 
speed, random access secondary storage (e.g., RAD stor- 
age). This feature means faster job execution because of 
minimized I/O delays, and smaller core memory require- 
ments because of rapid overlay service. (Reference: ANS 
COBOL/LN Reference Manual, 90 15 CO.) 



RPG 



Xerox RPG (Report Program Generator) is a convenient 
means of preparing reports from information available in 
computer-readable forms, such as punched cards, magnetic 
fape y and magnetic disks. In addition, it is a means of 
establishing and updating files of information, usually in 
conjunction with preparation of reports. 

RPG provides its capabilities through generation (compila- 
tion) of object programs, each of which is tailored to pro- 
duce a different set of reporting results and/or file processing 
desired by the user. The RPG object programs are capable 
of accepting input data, retrieving data from existing files, 
performing calculations, changing formats of data, updating 
existing files, creating new files, comparing data values 
to one another and to specified constants to determine 
appropriate handling, using user-defined processing sub- 
routines, using system library subroutines, and printing re- 
ports derived from the input and file data. 

Xerox RPG has several advantages over the more traditional 
method of writing object programs in a symbolic programming 
language. The RPG language is oriented toward the user's 
problem, describing reporting requirements, rather than 
toward the mechanics and manipulations of computer usage. 
The language and specification techniques are easily learned. 
A user can become proficient in RPG after writing only a 
few programs, whereas an equal facility in symbolic pro- 
gramming would require considerable experience. (Ref- 
erence: RPG/Reference Manual, 90 19 99.) 



APL 



APL is an acronym for A Programming Language, the lan- 
guage invented by Kenneth Iverson. It is an interpretive, 
problem-solving language. As an interpretive language, 
APL does not wait until a program is completed to compile 
it into object code and execute it; instead, APL interprets 
each line of input as it is entered to produce code that is 
immediately executed. As a problem-solving language, 
APL requires minimal computer programming know ledge; a 
problem is entered into the computer and an answer is re- 
ceived, all in the APL language. 



SIMULATION LANGUAGE (PROGRAM PRODUCT) 1 

The Simulation Language (SL-1) is a simplified, problem- 
oriented digital programming language designed specifically 
for digital or hybrid simulation. SL-1 is a superset of CSSL 
(Continuous System Simulation Language), the standard 
language specified by Simulation Councils, Inc., for 
simulation of continuous systems. It exceeds the cap- 
abilities of CSSL and other existing simulation languages 
by providing hybrid and real-time features, interactive 
debugging features, and a powerful set of conditional trans- 
lation features. 



Because APL is powerful, concise, easy to learn, and easy 
to use, it is widely used by universities, engineers, and 
statisticians. It also has features that make it attractive 
for business applications where user interaction and rapid 
feedback are key issues. One of APL's major strengths is 
its ability to manipulate vectors and multidimensional arrays 
as easily as it does scalar values. For example, a matrix 
addition that might require a number of statements and 
several loops in other languages can be accomplished as 
A + B in APL. This type of simplification exemplifies APL's 
concise power. (Reference: APL/LN,OPS Reference Man- 
ual, 90 19 31.) 



SL-1 is primarily useful in solving differential equations, a 
fundamental procedure in the simulation of parallel, con- 
tinuous systems. To perform this function, SL-1 includes 
six integration methods and the control logic for their use. 
In hybrid operations, SL-1 automatically synchronizes the 
problem solution to real-time and provides for hybrid input 
and output. 

Because of the versatility of Xerox computing systems and 
the broad applicability of digital and hybrid simulation 



See "program product" in glossary. 
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techniques, applications for SL-1 exist across the reai-time 
■ spectrum. The library concept of SL-i allows the user 
to expand upon the Xerox supplied macro set and facil- 
itates the development of macro libraries oriented to any 
desired application. (Reference- SL-l/Reference .Man- 
ual, 90 16 76.) 



EXECUTION CONTROL PROCESSORS 

Processors in this group control the execution of object pro- 
grams. Delta and COBOL On-Line Debugger can be used 
in on-line mode only. Load can be used in batch mode 
only. Link and FDP can be used in either batch or on- 
line mode. 



LINK 

Link is a one-pass linking loader that constructs a single 
entity called a load module, which Is an executable pro- 
gram formed from relocatable object modules (ROMs). • Link 
is designed to make full use of mapping hardware. It is not 
an overlay loader. If the need for an overlay loader exists, 
the overlay loader (Load) must be called and the job must 
be entered in the batch stream. (Reference: CP-V/TS 
Reference Manual, 90 09 07. ) 



LOAD 

Load is a two-pass overlay loader. The first pass processes 

1. All relocatable object modules (ROMs). 

2. Protection types and sizes for control and dummy sec- 
tions of the ROMs. 

3. Expressions for definitions and references (primary, 
secondary, and forward references). 

The second pass forms the actual core image and its re- 
location dictionary. (Reference: CP-V/BP Reference Man- 
ual, 90 17 64.) 

LYNX 

LYNX is a load processor that is available in both the on- 
line and batch modes. LYNX has most of the capabilities 
of the overlay loader and also provides the same control 
over internal and global symbol table construction which is 
available in the Link loader. LYNX may be viewed as a 
preprocessor for the overlay loader. After it analyzes the 
user's commands, it constructs a table of loader control in- 
formation which it then passes to the overlay loader. It is 
the overlay loader which actually performs the loading 
process. 



DELTA 

Delta is designed to aid in r'ne debugging of programs at 
the assembly-language or machine-language' levels. It 
operates oh object programs and tables of internal and glo- 
bal symbols used by the- programs but does not require that 
the tables be at hand. With or without the symbol tables, 
Delta recognizes computer instruction mnemonic codes and 
can assemble machine-language programs on an instruction- 
by-instruction basis. The main .purpose of Delta, however, 
is to facilitate the activities of debugging by 

1. Examining, inserting, and modifying such program 
elements as instructions, numeric values, and coded 
information (i.e., data in all its representations and 
formats). 

2. Controlling execution, including the insertion of break- 
points into a program and requests for breaks on 
changes in elements of data. 

3. Tracing execution by displaying information at desig- 
nated points in a program. 

4. Searching programs and data for specific elements and 
subelements. 

Although Delta is specifically tailored to machine language 
programs, it may be used to debug any program. Delta is 
designed and interfaced to the system in such a way that it 
may be called in to aid debugging at any time, even after 
a program has been loaded and execution has begun. (Ref- 
erence: CP-V/TS Reference Manual, 90 09 07.) 

FORTRAN DEBUG PACKAGE 

The FORTRAN Debug Package (FDP) is made up of special 
library routines that are called by Xerox Extended FOR- 
TRAN IV object programs compiled in the debug mode. 
These routines interact with the program to detect, diag- 
nose, and in many cases, repair program errors. 

The debugger can be used in batch and on-line modes. An 
extensive set of debugging commands are available in both 
cases. In batch operation, the debugging commands are 
included in the source input and are used by the debugger 
during execution of the program. In on-line operations, 
the debugging commands are entered through the terminal 
keyboard when requested by the debugger. Such requests 
are made when execution starts, stops, or restarts. The de- 
bugger normally has control of such stops. 

In addition to the debugging commands, the debugger has 
a few automatic debugging features. One of these features 
is the automatic comparison of standard calling and receiv- 
ing sequence arguments for type compatibility. When appli- 
cable, the number of arguments in the standard calling se- 
quence is checked for equality with the receiving sequence. 
These calling and receiving arguments are also tested for 
protection conflicts. Another automatic feature is the test- 
ing of subprogram dummy storage instructions to determine if 
they violate the protection of the calling argument. (Ref- 
erence: FDP/Reference Manual, 90 16 77.) 
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COBOL ON-LINE DEBUGGER 

The COBOL On-line Debugger is designed to be used with 
Xerox ANS COBOL. The debugger is a special COBOL 
run-time library routine that is called by programs compiled 
in the TEST mode. This routine allows the programmer to 
monitor and control both the execution of his program and 
the contents of data -items during on-lFrie execution. The 
debugger also allows^ the COBOL source program to be 
examined and modified. 

The debugger can only be used during on-line execution; 
however / programs that have been compiled for use with 
the debugger may be run in the batch mode. This is not 
recommended, though, because of the increased program 
size when the TEST mode is specified. (Reference: ANS 
COBOL/On-line Debugger Reference Manual, 90 30 60.) 



formatting, and converting da^a records. Additional file 
maintenance and utility commands are provided. (Reference: 
CP-V/TS Reference Manual, 90 09 07 and CP-V/BP Ref- 
erence Manual, 90 17 64. ) 



SYSGEN 

SYSGEN is made up of several processors. These proces- 
sors are used to generate a variety of CP-V systems that are 
tailored to the specific requirements of an installation. The 
SYSGEN processors are PASS2, LOCCT, PASS3, and DEF. 
PCL is used to select from various sources the relevant 
modules for system generation. PASS2 compiles the required 
dynamic tables for the resident monitor. LOCCT and PASS3 
file away and execute load card images to produce road 
modules for the monitor and its processors. DEF writes a 
monitor system tape that may be booted and used. (Refer- 
ence: CP-V/SM Reference Manual, 90 16 74.) 



SERVICE PROCESSORS 

The processors in this group perform general service func- 
tions required for running and using the CP-V system. 



EDIT 



The Edit processor is a l?ne-at-a-time context editor desig- 
nated for on-line creation, modification, and handling of 
programs and other bodies of information. All Edit data is 
stored on disk storage in a keyed file structure of sequence 
numbered, variable length records. This structure permits 
Edit to directly access each line or record of data. 



DEFCOM 

DEFCOM makes the DEFs and their associated values in one 
load module available to another load module. It accom- 
plishes this by using a load module as input and by produc- 
ing another load module that contains only the DEFs and 
DEF values from the input module. The resultant load 
module of DEFs can then be combined with other load 
modules. DEFCOM is used extensively in constructing the 
monitor and the shared run-time libraries. (Reference: 
CP-V/BP Reference Manual, 90 16 64.) 



Edit functions are controlled through single line commands 
supplied by the user. The command language provides for 
insertion, deletion, reordering, and replacement of lines 
or groups of lines of text. It also provides for selective 
printing, renumbering records, and context editing opera- 
tions of matching, moving, and substituting -line-by-line 
within a specified range of text lines. File maintenance 
commands are also provided to allow the user to build, copy, 
merge, and delete whole files. (Reference: CP-V/TS Ref- 
erence Manual, 90 09 07.) 



SYMCON 

The Symbol Control Processor (SYMCON) provides a means 
of controlling external symbols in a load module and of 
building a global symbol table. Its primary function is to 
give the programmer a means of preventing double defini- 
tions of external symbols. It may also be used to reduce 
the number of external symbols. For example, if certain 
load modules cannot be combined because their control 
tables are too large, the tables may be reduced in size by 
deleting all but essential external symbols. (Reference: 
CP-V/BP Reference Manual, 90 17 64.) 



PERIPHERAL CONVERSION LANGUAGE 

The Peripheral Conversion Language (PCL) is a utility sub- 
system designed for operation in the batch or on-line en- 
vironment. It provides for information movement among 
card devices, line printers, on-line terminals, magnetic 
tape devices, disk packs, and RAD storage. 

PCL is controlled by single-line commands supplied through 
on-line terminal input or through command card input in the 
job stream. The command language provides for single or 
multiple file transfers with options for selecting, sequencing, 



ANLZ 

ANLZ provides the system programmer with a means of ex- 
amining and analyzing the contents of dumps taken during 
system recovery. It is called automatically by the Automa- 
tic Recovery Procedure and is executed as a ghost job. It 
may also be called by the operator to analyze tape dumps 
when recovery is not possible, or by an on-line user to 
examine crash dumps or the currently running monitor. 
(Reference: Chapter 4. ) 
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BATCH 

The Batch processor is used to submit a file or a series of 
files to the batch queue for execution. Through Batch pro-, 
cessor commands, the following capabilities are available: 

1. A file may be inserted into a file being submitted -for 
execution, thus bringing together more than one file 
to create a single job. 

2. Selected strings and fields existing in files being sub- 
mitted for execution may be replaced by new strings 
and fields. 

3. The results of string and field replacements can be 
examined before the job is submitted to the batch 
stream. 

4. Files to be submitted for execution may reside on tape 
or private disk pack. 

5. Jobs may be submitted to run in an account other than 
the account from which the job is submitted. 

The Batch processor may be called in either the on-line or 
the batch mode. (Reference: CP-V/TS Reference Man- 
ual, 90 09 07.) 

DRSP 

DRSP (Dynamic Replacement of Shared Processors) enables 
the system programmer to dynamically add, replace, or 
delete processors during normal system operation with other 
users in the system. (Reference: Chapter 7.) 

ELLA 

The Error Log Listing program (ELLA) provides an efficient 
tool to list and sort the error data base which is automati- 
cally generated and updated by the CP-V system. (Refer- 
ence: Chapter 6.) 

SHOW .'".' 

The Show processor allows the user to display his current 
maximum system services and resources, the peripheral de- 
vices that he has been authorized to use, and several other 
system user parameters. (Reference: CP-V/BP Reference 
Manual, 90 17 64.) 

GENMD 

The GENMD processor that performs load module patching 
at boot time is available during normal system operation in 
ghost, batch, and online modes. As a ghost job, input 
and output is through the OC device with the format the 
same as during the boot process. As a batch job, input is 
through the M:C device and output is through M:LL. The 
format is the same os during the boot process except that 
the initial LMN may be specified on the processor control 
card (.'GENMD LMN). (See GENMD Commands, 
Chapter 3.) 

As an on-line processor, additional capabilities are 
available. The M:C DCB may be assigned to a file of 
patches; the M:SI DCB may be assigned (implicitly or 



explicitly) to the LMN to be patched; DELTA may be 
associated to simplify the patching format, and a descrip- 
tion of the input format may be obtained by typing a "?". 

LEMUR 

LEMUR (Library Editor and Maintenance Utility Routine) 
lets f he user construct, delete, or copy library modules of 
either the ROM or load module type. (Reference: CP-V/ 
BP Reference Manual 90 09 07). 

. APPLICATION PROCESSORS 

The application processors are intended for use for specific 
types of applications. 

SORT/MERGE 

The Xerox Sort/Merge processor provides the user with a 
fast, highly efficient method of sequencing a nonordered 
file. Sort may be called as a subroutine from within a user's 
program or a$ a batch processing job by control cards. It 
is designed to operate efficiently in a minimum hardware 
environment. Sorting can take place on from 1 to 16 keys 
and each individual key field may be sorted in ascending 
or descending sequence. The sorting technique used is 
that of replacement selection tournament and offers the 
user the flexibility of changing the blocking and logical 
record lengths in explicitly structured files to different 
values in the output file. 

The principal highlights of SORT are as follows: 

1. Sorting capability allows either magnetic tapes, disks, 
or both. 

2. Linkages allow execution of user's own code. 

3. Sorting on from 1 to 16 key fields in ascending or 
descending sequence is allowed. Keys may be alpha- 
numeric, binary, packed decimal, or zoned decimal 
data . 

4. Records may be fixed or variable length. 

5. Fixed length records may be blocked or unblocked. 

6. Disks may be used as file input or output devices, or 
as intermediate storage devices. 

7. Sort employs the read backward capability of the tape 
device to eliminate rewind time. 

8. User-specified character collating sequence may be 
used. 

9. Buffered input/output is used. 

(Reference: Sort-Merge/Reference Manual , 90 11 99). 

EDMS (PROGRAM PRODUCT)' 

ED MS is a generalized data management system that enables 
the user to create an integrated data base. It is designed 
to be used with COBOL, FORTRAN, and Meta-Symbol 
processors. It simplifies programming by performing most of 
the I/O logic and data base management for the applica- 
tion programmer. 

'See "program product" in glossary. 
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The principal features of EDMS are as follows: 

• The user can describe data in various data structures. 
Using sets, any element can be related to any other . 
element. Thedata structures inclu.de lists and hier- 
archies (trees); ■ The two relationships can be combined 
to form extensive networks of data. 

• Access techniques include random, direct, indexed, 
and indirect (relative to another record). 

• An EDMS data base may consist of up to 64 monitor 
files. 

• Multiple secondary indexes can be defined by the user 
to allow records to be retrieved via any combination 
of secondary record keys. 

• Users may construct any number of logical files or data 
bases within an EDMS file. 

• Data is described separately from the user program to 
facilitate management of the data base. 

• Comprehensive security exists at all levels of a file. 

• Journalization provides an audit trail for backup and 
recovery. 

• A dynamic space inventory is maintained to facilitate 
rapid record storage and to optimize the use of avail- 
able storage space. 

• Detailed data description is provided for inclusion into 
the user's application program to reduce programming 
effort. 

• File I/O logic is performed for the user program 
including 

1. Logical or physical record deletion. 

2. Record retrieval on random or search basis. 

3. Record insertion or modification. 
(Reference: EDMS/Reference Manual, 90 30 12.) 

GPDS (PROGRAM PRODUCT)' 

The General Purpose Discrete Simulator provides engineers 
and administrators, whose programming experience is mini- 
mal, with a system for experimenting with and evaluating 
system methods, processes, and designs. Providing a means 
for developing a broad range of simulation models, it allows 
organizing, modeling, and analyzing the structure of a sys- 
tem, observing the flow of traffic, etc. Potential applica- 
tions include 

• Advanced management planning. 

• Analysis of inventory or financial systems. 



« Studies of message switching and communications 
networks. 

o Risk and capital investment studies. 

'•<■ Evaluation and data processing systems. 

• Job shopand queuing studies. 

Although GPDS is compatible with other simulator systems, 
it has a number of satient features not usually found in 
competitive versions. (Reference: GPDS/Reference Man- 
ual, 90 17 58.) 

MANAGE (PROGRAM PRODUCT)* 

Manage is a generalized file management system. It is 
designed to allow decision makers to make use of the computer 
to generate and update files, retrieve useful data, and gen- 
erate reports without having a knowledge of programming. 

Manage consists of four subprograms: Dictionary, Fileup, 
Retrieve, and Report. The Dictionary subprogram is a data 
file and is the central control element in the Manage sys- 
tem. It consists of definitions and control and formatting 
parameters that precisely describe the characteristics of a 
data file. The Fileup Subprogram initially creates and then 
maintains a data file. The Retrieve subprogram extracts data 
from a data base file according to user-specified criteria. 
The Report subprogram automatically prepares printed reports 
for data extracted by the Manage retrieval program. (Ref- 
erence: Manage/Reference Manual, 90 16 10. ) 

CIRC (PROGRAM PRODUCT)* 

CIRC is a set of three computer programs for electronic cir- 
cuit analysis: C1RC-DC for dc circuit analysis, CIRC-AC 
for ac circuit analysis, and CIRC-TR for transient circuit 
analysis. The programs are designed for use by a circuit 
engineer, and require little or no knowledge of programming 
for execution. 

CIRC can be executed with three modes of operation pos- 
sible: conversational (on-line) mode, terminal batch entry 
mode, and batch processing mode. The system manager will 
determine which of these modes are available to the engi- 
neer, based on type of computer installation and other, in- 
stallation decisions. 

• The on-line mode offers several advantages since it 
provides true conversational interaction between the 
user and computer. Following CIRCstart-up procedures, 
CIRC requests a control message from the user. After 
the control message is input (e.g., iterate a cycle of 
calculations with changed parameters) the computer 
responds (via CIRC) with detailed requests for appli- 
cation data. These requests are sufficiently detailed to 



See "program product" in glossary. 
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virtually eliminate misunderstandings by the engineer. 
This mode is highly useful in a highly interactive en- 
vironment that produces a low vojume of output and 
requires limited CPU time. 

The terminal batch entry mode allows efficient handling 
of high volume output and large CPU time requirements 
while preserving the advantages of the terminal as an 
input device. Two files are required, one containing 
all CIRC input including a circuit description and 
control messages and the other directing the execution 
of CIRC. The job is entered from the terminal into the 
batch queue and treated like a batch job. 

The batch mode should generally be used for jobs in- 
volving large volumes of computations and outputs. It 
enables the user to concentrate on data preparation 
with virtually no involvement in programming consider- 
ations. The system manager can provide a set of 
start-up cards that never change, and these will con- 
stitute the entire interface between user and executive 
software. However, the batch mode offers less flexi- 
bility in experimenting with a circuit and slower 
turnaround time in obtaining answers. 



(References: ClRC-AC/Reference Manual and User's Guide, 
90 16 98, CIRC-DC/Reference Manual and User's Guide, 
90 16 97, and CIRC-TR/Reference Manual and User's 
Guide, 90 17 86.) 



8. Terminal l/O Handling. 

9. Symbionts, 

10. Cooperatives. 

11. System Integrity. 

12. Initialization and Start-up. 

13. Operator Communications. . 

14. Batch Debugging. 

15. Load -and -Link. 

16. System Debugging. 



The basic control system is an I/O Interrupt service and 
handling routine. It includes trap and interrupt handlers, 
routines that place requests for I/O in a queue, and basic 
device I/O handling routines. 



The scheduling and swapping module makes the decision to 
swap, selects the users to swap in and out, sets up the I/O 
command chains for swap transfers, and selects the next user 
for execution. It also ensures that any associated, but not 
currently resident, shared processors are brought in with 
each user. Special algorithms control I/O scheduling and 
the balance of machine use between on-line and batch. 



USER PROCESSORS 

Users may write their own processors and add them to 
CP-V or replace CP-V processors. The rules governing the 
creation and modification of processors are described in 
Chapter 7. 



MONITOR 

The monitor responds to the moment-by-moment require- 
ments of controlling machine operation, switching between 
programs requiring service, and providing services at the 
explicit request of the user's program. The monitor pro- 
grams that perform these functions are listed below. 

1. Basic Control. 

2. Scheduling and Swapping. 

3. Memory Management. 

4. File Management. 

5. Multibatch Job Scheduling. 

6. Resource Management. 

7. Job Step Control. 



The memory management module controls the use of core 
and disk storage. Specifically, it controls the allocation of 
physical core memory, maintains the map and access images 
for each user, services the "get" and "free" service calls 
for memory pages, and manages the swapping disk space. 



File management routines control the content and access to 
physical files of information. These routines perform such 
functions as indexing, blocking and deblocking, managing 
of pools of granules on RADs and disk packs, labeling, la- 
bel checking and positioning of magnetic tape, formatting 
for printer and card equipment, and controlling access to 
and simultaneous use of a hierarchy of files. 



The multibatch job scheduling routines select jobs to be run 
from the waiting input queue depending on priority and re- 
source and partition availability. 



Resource management facilities keep track of the number 
of resources of each kind (i.e., tape drives, disk spindles, 
core) that are in use. For a batch job, the multi-batch 
scheduler compares the resources required with the avail- 
able resources and does not start the job until sufficient 
resources are available. Once the job is started, the re- 
sources that are required by the job are reserved for the 
exclusive use of the job, thereby guaranteeing that they 
will be available for the duration of the job. 
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Job step control routines are entered between major segments 
of a job or an on-line session. They perform the monitor 
functions required between job steps such as 

.1. Processing error exit and abort CALs. 

2. Handling monitor aborts." 



.3. Processing interpretive exits to associated shared pro- 
cessors or to load program modules.. 

4. Merging DCB assignments for execution. 

5. Checking user authorization for individual processors. 

6. Fetching program load modules into core. 



Terminal I/O handling routines perform read-write buffer- 
ing and external interrupt handling for I/O directed to user 
terminals. These routines also translate character codes, 
insert page headers and VFC control characters, simulate 
tabs, and perform other formatting tasks. 



Symbiont routines transfer data from the card reader to log- 
ical device streams on disk storage and from logical device 
streams on disk storage to the card punch or line printer. 

Cooperative routines intercept read, print, or punch com- 
mands in user programs and transfer data from or to logical 
device streams residing on disk storage. The input coopera- 
tive simulates card reading from a logical device stream. 
The output cooperative builds a logical device stream using 
intercepted program output directed by the user program to 
a line printer or card punch. 

System integrity facilities provide error detection and re- 
covery capabilities. This includes security to user files and 
automatic high-speed restart in case of system failure. Suf- 
ficient information is recorded to isolate errors and failures 
caused by hardware or software. 

Initialization and start-up routines are stored on tape and 
are booted into core storage. After they are in core, they 
load the monitor root into core and turn control over to the 
root. The monitor root then completes the initialization 
of the monitor by starting and running the program called 
GHOST1 which completes the patching of the system and 
the initialization of the swapping disk and hardware. 

Operator communication routines provide for communica- 
tion between the monitor and the operator. They transmit 
messages to the operator and process key-ins received from 
the operator. 



Batch debugg ing routines provide batch programs with 
debugging capability through the use of procedure calls. 
Any batch program may take a snapshot=dump of a specified 
segment of memory, either' on an unconditional or a con- 
ditional basis. 



System debugging routines provide debugging services to 
system programmers. Three debugging routines are avail- 
able. They are 

1. Executive Delta: This is a stand-alone processor and 
is essentially the same as on-line Delta. Executive 
Delta is optionally loaded at boot time along with the 
root of the monitor and monitor system tables. 

2. Analyze: This program is intended for debugging CP-V 
crash dumps. To accomplish this, it performs two 
major functions. 

a. It summarizes the complete software environment 
at the time of the crash in a series of tables. 

b. It permits on-line interactions similar to Delta. 

3. Recover; This program provides the "bail-out" exit 
from the monitor. The error code that is transmitted 
to RECOVER defines the problem and the module that 
discovered the problem. 

Load-and-link routines give batch programs three types of 
loading and linking capability. Through the use of proce- 
dure calls, a batch program may 

1. Load an overlay segment into core storage. 

2. Store the calling program on disk storage, load the 
called program into core storage, and transfer control 
to the called program. 

3. Load a program into core storage, transfer control to 
the called program, and release the core area used by 
the calling program. 

4. Pass a command line to the called program. 

CP-V has two types of FORTRAN libraries. One type is a 
public library and the other is a system library. In the 
standard release of CP-V, there are three FORTRAN public 
libraries. One library (Pl)contains a useful set of Extended 
FORTRAN IV run-time library routines; another (PO) contains 
PI and the FORTRAN Debug Package; the third <P4) con- 
tains PI and the FORTRAN real-time features. These three 
libraries are so constructed that a single copy is shared among 
all concurrent users. The system library contains a collec- 
tion of routines that are less frequently used than the public 
library routines. They are in library load module form and 
are loaded only with programs that reference them. 



SCHEDULING AND MEMORY MANAGEMENT 

Scheduling and memory management routines control the 
overall operation of the system. Inputs to these routines, 
together with the current status of users as recorded by the 



14 Monitor 



90 31 13B- 1(11/76) 



.cheduier, are used to- change the position of each user in 
the scheduling status queues. It is from these queues that 
selections are made for both swapping and execution. Swaps 
are set up by the selection of a high priority user that is to 
be brought into core and by pairing this user with one or 
more low priority users that are to be transferred to disk 
storage. Similarly, the highest priority user in core is 
selected for execution. 



SCHEDULER INPUTS 

System activities are reported by direct entry to the sched- 
uler, which makes changes to user status queues through a 
logical signaling table. The scheduler records inputs by 
changing the user status queues and other information asso- 
ciated with the user. In general, a table-driven technique 
is used. The received signal is on one coordinate and the 
current state of the user is on the other. The table entry 
thus defined names the routine to be executed in response 
to the given signal-state combination. Since the number 
of signals and states is large, the table technique aids in 
debugging by forcing complete specification of all the pos- 
sibilities. Inputs to the scheduler are listed in Table 1. 
The scheduler also receives control at execution of each 
CAL issued by a user program that is requesting monitor 
service. These entries (Table 2), special entries from the 
command processors, and entries from internally reported 
events drive the scheduling of the system. 

Table I. Event Inputs Received by Scheduler 



Table 1. Event Inputs Received by Scheduler (cont. ) 



Event 


Meaning 


E:ABRT 


Operator aborted user. 


E:AP 


Associate shared processor with user. 


E:ART 


Activate real-time user. Interrupt has 
occurred. 


E:CBA 


COC buffer available. 


E:CBK 


Break signal received. 


E:CBL 


Number of output characters > SL:TB. 


E:CEC 


TEL request (©©, ©Y, or Y c ). 


E:CFB 


Cannot find COC buffer. 


E:CIC 


Terminal input message complete. 


E:CRD 


Read terminal command received. 


E:CUB 


Number of output characters = SL:UB. 


E:DPA 


RAD page available. 


E:ERR 


Operator errored user. 


E:IC 


I/O complete. 



Event 


Meaning 


E:IIP 


I/O started and now in progress. 


E:IP 


Request permission to sfart I/O. 


EfKO 


User removed from core. 


E:NC 


Cannot get requested core pages. 


E:ND 


Cannot get requested disk page. 


E:NOCR 


User allowed to open or close file. 


E:NSYMD 


No symbiont disk space. 


ErNSYMF 


No symbiont file entry. 


E-.NQR 


Enqueue release —resource available. 


E:NQW 


Enqueue —wait for resource. 


E:OCR 


Request permission to open or close file. 


E:OFF 


User has hung up telephone. 


E:QA 


User queued for access (e.g., for access 




to tape or disk pack). 


E:QE 


Quantum end. 


ErQFAC 


No granules available for use. 


E:QFI 


Real-time user. Queue for interrupt. 


E:QMF 


Queue for I/O master function count too 




high. 


E:SL 


Sleep time for user. 


ErSYMF 


Symbiont file now available. 


E:SYMD 


Symbiont disk space now available. 


E-.UQA 


User dequeued for access (e.g., for ac- 




cess to tape or disk pack). 


E:UQFAC 


ALLOCAT has refreshed granule stacks. 


E:WU 


Wake -up time for user. 
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Table 2. Service Request Input to Monitor 



Source of Inputs 


Service Request Entries 


User program 5. 


■1. 


Terminal input/output request. 


" (through monitor 






service calls) 


-%. 


Input/output service calls for 
RAD, disk pack, Or magnetic, 
tape. 




3. 


Wait request. 




4. 


Program exit (complete). 




5. 


Core request (for common, 
dynamic, or specific pages). 




6. 


Real-time services. 




7. 


Program overlay (load and 
link, load and transfer). 




8. 


Debug requests. 




9. 


Miscellaneous service requests. 


Command 


1. 


i 

Name of system programs to 


processor 




be loaded and entered (im- 
plies deletion of any current 
program). 




2. 


Continuation signal. 




3. 


Special continuation address. 




4. 


Link load -and -go-exit. 



The second function the scheduler performs consists of 
selecting a user for execution according. to .the priority state 
queues and the. rules for batch processing. The rule is 
simple: the highest priority user whose program and data 
are in core is, selected. 



USER STATUS QUEUES 

Status queues form a single priority structure from which se- 
lections for swapping and execution are made. The status 
queues form an ordered list with one and only one entry for 
each user. The position in queue is an implied bid for 
the services of the computer. As events are signaled to the 
scheduler, individual users move up and down in the prior- 
ity structure. When they are at the high end, they have a 
high priority for swapping into core and for execution. When 
they are at the low end, they are prime candidates for re- 
moval to secondary storage. This latter feature — that of 
having a defined priority for removal of users to disk stor- 
age — is an important and often overlooked aid to efficient 
swap management. It avoids extraneous swaps by making 
an intelligent choice about outgoing as well as incoming 
users. 

In addition to these primary functions, user status queues 
have other functions such as 

1. Synchronizing the presence in core of the user program 
and data with the availability of I/O devices. 

2. Queuing user programs to be "awakened" at a preestab- 
lished time. 

3. Queuing requests for entry and use of processors. 

4. Managing core memory. 

5. Queuing requests for buffers either in core or on 
disk. 

6. Queuing requests for nonresident monitor services. 
A list of the status queues is given in Table 3. 



SCHEDULER OUTPUT 

The scheduling routine performs two major functions during 
the time it is in control of the computer. The first function 
consists of setting up swaps between main core memory and 
secondary disk storage in such a way that high priority users 
are brought into core to replace low priority users that are 
transferred to disk storage. The actual swap is controlled 
by an I/O handler according to specifications prepared by 
the scheduler. These specifications are prepared according 
to the priority state queues described in the next section. 
Given a suitably large ratio of available core to average 
user size (greater than 4), the scheduler can keep swaps 
and computing close to TOO percent overlapped. 



SCHEDULER OPERATION 

To select users for execution, the scheduler searches down 
a list of the status queues for the first user in core memory. 
The highest priority user Is served first. Interrupting users 
are served before those with an active input message (both 
of these take precedence over users with unblocked termi- 
nal output), then come on-line compute-bound users and 
finally, compute-bound batch jobs. Note that users in 
lower states have no current requests for CPU resources. 
Note also that as each user is selected for execution, the 
status queue of the user is changed to CU. When the quan- 
tum is complete, the highest priority queue the user can 
enter is the compute queue. Users that enter any of the 



16 



Monitor 



Table 3. Scheduler Status Queues 



State 



SRT 
SCO 

SCT 

SC2 

SC3 

SC4 

SC5 

SC6 

SC7 

SC8 

SC9 

SCIO 

STOB 

STOBO 
SIOW 

SIOMF 

SW 
SQA 

SQR 



Meaning 



SQRO 

STI 

STIO 
SQF1 



Real-time execute (0^ priority S X'BF'). 

Background execute fX'CO' < 
priority ^ X'F5'). 

Background execute" (priority = X'Fo 1 ). 

Background execute (priority = X-'F7*) # 

Background execute (priority = X'F8')>-' 

Background execute (priority = XT '). 

Background execute (priority = X'FA'). 

Background execute (priority = X'FB'). 

Background execute (priority = X'FC). 

Background execute (priority = X'FD 1 ). 

Background execute (priority = X'FE'). 

Background execute (priority = X'FF 1 ). 

Terminal output blocked in core. (More 
characters than the system limit are ready 
for typing.) 

Terminal output blocked. Not in core. 

I/O wait. Users waiting for an I/O that is 
in progress to complete. 

Users blocked because I/O master function 
count (number of I/O operations in progress) 
has reached the system limit. 

Users waiting for a specified "wake-up" 
time. 

Users waiting for service by RBBAT, the 
symbiont ghost. 

Users in core and blocked for dynamic re- 
source such as swapper page, COC buffer, 
symbiont disk page, symbiont table space, 
enqueued resource, service by ALLOCAT 
(for file granules), or file open or close. 

Same as SQR but not in core. 

Typing input and in core. 

Typing input and not in core. 
Real-time user waiting for interrupt. 



three highest priority states receive rapid response but only 
for the first quanfa of service. Thereafter, they share ser- 
vice with oihers in the compute queue. 

A similar selection procedure is used ■■ to set up users for .- 
swapping. First, the highest priority user in the execution 
queue who is not in core is selected and his size require-, 
ment (including the requirement for shared processors not in 
core) is determined. Second) users are selected from the 
swapout queue until enough space is "freed by these users 
and their shared processors to provide for the user selected 
for sv/ap-in. If a single user in a sfate'feelbw SCIO (Table 3) 
can be found to swap out, then a single rather than a multi- 
ple swap is chosen. No swaps occur until a user that is not 
in core enters a high priority queue. 

Two lists resulting from this selection are presented to the 
swapper. One list contains the user (or users) to be swapped 
out and the other contains the user to be swapped in. This 
latter list also contains the shared processors that must 
accompany the user and the current free core page list. 
When the scheduler selects users for swapping, it picks a 
high priority user to load into core and the lowest priority 
user to remove from core. Priorities are arranged from high 
to low, in order of increasing expected time before the next 
activation. This ensures that the users that are least likely 
to be needed are swapped out first, while the users most 
likely to require execution are retained in core. The swap 
algorithm operates so that compute users remain in core and 
use all available compute time, while the interactive users 
are swapped through the third core slot whenever the fol- 
lowing three conditions exist: 

1. There is room in core for three user programs. 

2. Two users are computing steadily. 

3. Many other users are doing short interactive tasks. 



Table 4 shows the queue used for selection of users to be 
brought in for execution and the queue used for selection 
of users to be moved to disk. 



Note that the queues CU, IOW, QRO, TOBO, TIO do not 
appear in either list. Thus, the users in these states are not 
selected either for execution or for swapping. 

Two examples of typical interactive use are illustrative of 
the scheduling operation. 

The first example traces scheduling operations for a simple, 
short interactive user request. At the time the request is 
typed, the user is in the STI queue. His program, which 
has probably been swapped to disk storage, remains there 
until the COC routines receive an activation character. 
Receipt of this character is reported to the scheduler 
and causes a change in state of the user to the appro- 
priate executable state (SCO- SCIO). The scheduler finds 
a high priority user not in core and initiates a swap to 
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Table 4. Swap-In and Swap-Out Queues 



„. Swap-In 




(and Execution) 


Swap-Out 


Queue 


Queue 


SRT 


sw 


SCO 


ST1 


SCT 


STOB 


SC2 


SQFI 


SC3 


SQA 


SC4 


SC10 


SC5 


SQR 


SC6 


SC9 


SC7 


SC8 


SC8 


SC7 


SC9 


SC6 


SC10 


SC5 




SC4 




SC3 




SC2 




SCI 




SCO 




SRT 



this typing time, the program is'nor required in core and 
the CPU resources can be given to other programs. 



remove a low priority user (if necessary) and to bring 
in the one just activated. On completion of the swap, 
the scheduler is again called and now finds a high priority 
user ready to run. The user's state is changed to CU, the 
program is entered, and the input command is examined by 
the reading program. The cycle in this example is com- 
pleted by preparation of a response line and a request to 
the monitor for more input which changes the user's state 
to TI again, making him a prime candidate for removal 
to disk. 



I/O SCHEDULING 

I/O scheduling is designed to provide good service to I/O- 
bound users while keeping the CPU busy with compute- 
bound users. The intent is to make the fullest possible 
utilization of both the CPU and the I/O devices. The 
manner in which this is accomplished is described below. 



A user that has been waiting for an I/O to complete (SIOW) 
is changed to an executable state at a priority slightly 
higher than a similar compute-bound user when the I/O 
completes. At that time, the execution scheduler inter- 
rupts the execution of the compute-bound user so that the 
I/O-bound user can execute. The I/O-bound user requires 
comparatively little CPU time before initiating another I/O 
request and returning to the SIOW state. The compute- 
bound user then resumes execution. 



It should be noted that the scheduler automatically adapts 
to jobs that alternate between bursts of computing and bursts 
of I/O. 



SWAP HARDWARE ORGANIZATION 

Users are removed from core to a dedicated area of disk 
storage (or to several disks in large configurations) when 
core is required for higher priority users. 



Bit tables are used to keep track of the availability of each 
sector on the disks. In these tables, a zero is used to indi- 
cate the sector is in use (usually assigned to a user) and a 
one is used to indicate the sector is available. Users are 
assigned a sufficient number of page-size sectors to accom- 
modate their current use. The assignment is done in such a 
way that command chaining of the I/O can order the sectors 
to be fetched for a single user with minimum latency. That 
is, each user's pages are spread evenly over the set of 
available sectors on the disk to which he is dedicated so 
that data will be transmitted in every disk sector passed 
over when the user is swapped. 



The second example illustrates an output-bound terminal 
program. This program moves through the state cycle STOB- 
SC-SCU as output is generated by the program. The COC 
routines signal when the output limit has been reached, 
thus causing the program to be delayed while output is 
transferred to the terminal. In a typical operation, four 
to six seconds of typing is readied in buffers each time the 
user program is brought into core and executed. During 



The records of disk sectors associated with each user are 
kept In the user's job information table (JIT), which is kept 
on disk when the user is not in core. The disk location of 
the JIT and the user's disk address are kept in core by the 
scheduler. The disk layout is such that sufficient time is 
available after the user's JIT arrives from the disk for the 
system to set up the I/O commands for the remainder of 
the user. 
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The amount of disk storage assigned to swapping is a 
parameter of SYSGEN. The 'number of on-line users that 
the system can accommodate, is limited by the size of disk 
space allocated for swapping and the total size of active 
on-line users. 



Due to the system configuration and SYSGEN, at most 
six sets of devices can be created: 



1. RAD all PFA (PFA RAD first). 



The allocation scheme for systems. which have file space 
allocated on both RADs and disk packs is described in the 
following paragraphs. 



2. Pack all PFA (PFA pack first). 

3. All PER (PER first). 



For the sake of overall performance, the RAD is preferred 
for frequently accessed system information and temporary 
files used by the major processors. Special users who 
need high performance on special files may specify RAD 
preference. 



4. RAD PFA plus PER and/or PSA (PFA RAD second, 
PER second). 

5. Pack PFA plus PER and/or PSA (PFA pack second, 
PER third). 



All of the account directory and all files from :SYS are as- 
signed to the RAD. The first granule of each file directory 
is assigned to disk pack but any additional granules are as- 
signed to RAD. All star or id files and all scratch files 
(opened OUT or OUTIN with REL) prefer RAD. Random 
files with no user stated preference and all other files and 
their indexes prefer pack. These pack preferences may be 
overridden either by the operator keyin 'PREFER* for all 
files or by the user specification of NOSEP and DEVICE 
for individual files. 



Briefly, the effect of authorization and defaults upon the 
allocation is: If not enough space is available on the pre- 
ferred device, the other device will be used if space is 
available there. The exception to this is random files with 
user specified preference. In this case, if space is not 
available on the user specified device, the file is not al- 
located and an error is returned to the user. Also, within 
the authorized limits, temporary files may use only tempo- 
rary authorization and permanent files may use only perma- 
nent authorization. 



In general, the rule for authorization should be: A large 
amount of temporary RAD and disk pack space should be 
authorized for all users and the amount of permanent disk 
space should be individually authorized by need. Very few 
users should be authorized permanent RAD space. 



6. PER plus PSA (PER fourth). 

Granules are selected for the in-core buffers from one of 
the six sets of devices starting each device at sector zero 
and allocating from all the devices within the set simul- 
taneously (i.e., round-robin). The preference in choice 
of sets is noted above in parentheses. All devices of a set 
will be depleted before the next set is chosen. 



Cylinders for the in-core buffer are allocated starting at 
cylinder zero of the first (lowest DCT index) cylinder al- 
located device. Each device will be depleted before the 
next is used. 



Random files are allocated starting at the last sector of the 
last (highest DCT index) device of the proper type. The 
cylinder allocated devices are treated as one continuum 
of space for random files. They need not be contiguous in 
the DCT table and any file may cross a boundary (even a 
two cylinder file). Private random files are allocated in 
the same way. 



There are four in-core buffers for types of space to be al- 
located. Three are for granule allocated devices: 

1. RAD PFA (permanent file storage). 

2. Pack PFA (permanent file storage). 

3. PER (peripheral symbiont storage). 

The fourth is for cylinder requests. These buffers are used 
to satisfy requests for all purposes except directories, random 
files, and PSA (permanent system storage and swapping). 



PROCESSOR MANAGEMENT 

CP-V processors are considered shared processors when they 
are written in such a way that they are pure procedure and 
are described as such when they are added to the system. 
(User-associated data areas are initialized at first entry.) 
A shared processor has the following special characteristics: 

1. It has dedicated residency on swap storage established 
at system initialization or via DRSP. 

2. A single copy is shared by all requesting users. 
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MEMORY LAYOUT 

The system makes full use of address mapping hardware, 
access protection, and write locks in allocating available 
physical core pages to users. Physical core pages are allo- 
cated to users at their request. Use of the map obviates 
the need for program relocation or physical moves. Full 
Infection is provided for one user from another. All pro- 
gVns and the monitor itself are divided into procedure and 
data. The procedure area is protected by write-locks or 
access codes, or both, against inadvertent stores. 



The central features of the use of write-locks to protect 
master mode programs are as follows: 

1. The monitor operates with a key of 01 and may store in 

xj. Its own dota area (LOCK = 01 ). 

b. Any batch, on-line or shared processor code 
(LOCK =00). 

It may not store in its own procedure (LOCK = 11). 

2. Keys of 10 and~ll are never used, nor is the lockof 10. 

3. Write-locks are initiq.Uzed,onty ©n*e at system start-up 
and are not changed thereaftet except when running 
under control of Executive Delta where they are used 
to enable data breakpoints. 

4. On the Xerox 560, write keys are four bits long and 
apply to the IOP memory writes as well as CPU write 
(operations. To take advantage of this feature, the 
Xerox 560 I/O system always uses a key of 1000 which 
does not match any of the locks. This means that no 
I/O operation can accidentally overwrite the monitor or 
its data since the IOPscan only write into memory with 
locks of zero (the user area). Also on the Xerox 560, 
certain monitor buffers which are part of the monitor data 
area (usually with lock 01) are grouped together and the 
pages containing those buffers are set to a lock of 0000. 
Except for this difference, the rest of the locks are 
bxactly the same as for the Sigma computers. 



The access code on virtual memory pages controls references 
made by slave mode programs (user programs and shared pro- 
cessors). This code is retained in the JIT of each user and is 
loaded into the hardware access protect registers (which are 
part of the virtual mapping hardware) when the user gains 
control. Write access to JIT and other job context areas is 
given to TEL, CCI, LOGON, and any installation-defined 
command processors. 



The layout of virtual memory that applies to user programs 
and ordinarily shared processors is shown in Figure 2. Al- 
location of the available area depends on the type of 
that is running and the attributes of the load module 



to be executed 1 . Allocation Type II is used when o core 
library or debugger is associated or when the load module 
to be executed has been built by Link. In al! other casei, 
allocation of the available area is as shown in Type I for 
batch users/ghost jobs,, and on-line users executing in the 
extended memory mode. 



Core addresses shown are those appropriate for a typical 
system but more (or less) core may be established for the 
resident monitor at SYSGEN time depending on installation 
needs. More (or less) area may also be desirable for the 
library area and for the job context area to accommodate 
more buffers. These bounds may also be adjusted at SYSGEN 
time. The boundary at which the one-pass loader (Link) 
places the user program is also adjustable. 

Virtual pages not currently allocated to the user are mapped 
into a resident monitor page that is write-locked, (the ac- 
cess code is set to no access). Thus, slave mode programs 
are denied access through the access code, and attempts to 
store at these virtual addresses by a master mode program 
are protected by write locks. 

Typical layouts of physical memory are shown in Figure 3 
for Sigma systems and in Figure 4 for Xerox 560 systems. 
Although these are similar to the actual layout, they should 
not be assumed to be exact. 



SYSTEM INTEGRITY 

The monitor has a number of routines that have been in- 
cluded to guarantee system integrity. The objectives of 
these routines are, in order of importance, (1) to provide 
the highest possible security for user files even in the event 
of total system failure, (2) to provide automatic high-speed 
recovery in the event of a machine or software failure, and 
(3) to record sufficient information to isolate errors and 
failures caused by either hardware or software. 

The major features of the CP-V system integrity routines are 
as follows: 

1. Detection of malfunctions by hardware examination 
and software checks wherever the checks have been 
shown to enhance hardware error detection. Recovery 
from these malfunctions is through retries, operator as- 
sistance, etc. 

2. Logging of all malfunctions, including recovered errors 
and permanent failures. 

3. Protection from hardware failures. 

4. Use of on-line exercisers to provide for repair or ad- 
justment of peripherals without taking the CPU down. 

5. File backup and recovery facilities to minimize the 
probability of losing user files, and in case of file 
failure, to facilitate complete recovery of the file sys- 
tem with a minimum of loss. 
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Job information 
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File index buffers 
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Available Area 

User programs, data, DCBs, and symbol tables 
Ordinary shared processors including 

Root segment 

Initial data 

Overlay area 



Special Area 

Special shared processor and data: 
Link 
Delta 
TEL 
Libraries 



Access none — no access of any kind permitted 

codes read — read access only 



execute — execute or read access 

write —write, execute, and read permitted 



Figure 2. Typical User Program —Virtual Memory Layout (not to scale) 
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Figure 3. Typical Memory Layout for Sigma Computers (not to scale) 
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Resident monitor 
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All user jobs and processors 
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Program 
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0000 
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0011 
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Locks 



(The I/O system always uses a write key of 1000.) 



Figure 4. Typical Memory Layout for the Xerox 560 (not to scale) 



6. Automatic recovery following a system failure with 
reasonable speed consistent with file security and the 
recording of information for later analysis. 

7. Facilities to provide for analysis of system crashes. In- 
formation includes simple classification of failures as 
well as full information for both customer engineers 
and system programmers. 



8. For the Xerox 560 
assistance. 



on-line interface for remote 



ERROR AND FAILURE LOGGING 

Malfunction messages are maintained in a special file by 
system integrity routines. Messages are placed in this file 
whenever malfunctions are detected by the various parts of 
the system. Hardware malfunctions that are recorded in- 
clude such things as tape errors, card reader errors, memory 
parity errors, and illegal instructions. Software malfunctions 
that are recorded include the failure of software checks 
on RAD or disk addresses contained in index blocks and 
improper linkage of linked file blocks. In addition, a 
software recovery from a seek failure is recorded in this 
file (as a 757F code). 



ERROR DETECTION AND RECOVERY 

An effective operating system must be able to detect and, 
whenever possible, to correct errors. It must also be cap- 
able of restarting the system if necessary. CP-V uses a 
combination of hardware and software checks to efficiently 
meet these goals. 

Hardware error protection features include memory protec- 
tion against accidental overwriting of monitor and user pro- 
grams, power fail-safe interrupts that ensure automatic 
restart in the event of power failure, memory parity check- 
ing, I/O read and write verification, and a watchdog timer 
to avoid instruction hangups. Detected errors are reported, 
logged, and if possible, recovered directly. Catastrophic 
failures cause an automatic system recovery if at all pos- 
sible. Those failures which can be isolated to a single user 
cause only that user to be aborted. Some hardware errors, 
such as loss of a memory power supply, lead to system 
shutdown. 



The error messages generated throughout the system (report- 
ing both hardware and software errors) are placed initially 
in in-core buffers and then are transferred to a special file 
(actually a linked list of granules). This transfer is initiated 
whenever an error count threshold, or time limit is reached. 
This special file is then transferred to an ordered keyed file. 
(ERRFILE) by the standard system ghost processor ERR:FIL 
which is automatically awakened by the system. 



ERROR LOG LISTING 

This keyed file (ERRFILE) may be listed and sorted by the 
processor ELLA which allows the Customer Engineer to dis- 
play and search the error file for patterns of errors to aid in 
preventive maintenance for the system. 



Software consistency checks, some of which are performed 
optionally on the setting of a console sense switch, check 
the integrity of the software at many critical locations In 
the system. These checks detect problems before they are 
allowed to go beyond a recoverable point. When an incon- 
sistency that is catastrophic to the system is detected, the 
current users are logged off and all open files are closed. 
The system is then automatically rebooted for the fastest 
possible restart. 



ON-LINE DIAGNOSTICS AND EXERCISERS 

On-fine diagnostics and exercisers may be called when 
there is a specific failure detected by the hardware or soft- 
ware, or when a failure is projected through analysis of the 
error log by the Customer Engineer. These programs may 
also be called by the Customer Engineer when needed for 
the test or adjustment of the card reader, card punch, line 
printer, magnetic tape, or other devices. 
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REMOTE DIAGNOSTIC ASSISTANCE 

On the Xerox 560, on-line diagnostics and certain on-line 
debugging processors (ANLZ, Delta, and ELLA) may be 
utilized via the Remote Assist Station (RAS) interface. 

After control is obtained from the local' operator, customer 
engineers and/or diagnostic programmers at remote locations 
may access the system via this interface without interfering 
with the on-line COC users and without using any of the 
normal communication equipment. By evaluating the sys- 
tem under normal operating conditions, many software errors 
and hardware malfunctions may be detected and eliminated 
expeditiously with a minimum of computer down time. 



FILE MAINTENANCE 

CP-V provides a variety of processors designed to maintain 
a reliable backup of the file data base. These processors are 
summarized in the CP-V/SM Reference Manual, 90 16 74, 
and are described in detail in the CP-V/OPS Reference 
Manual, 90 16 75. The processors provide the ability to 
save and restore large volumes of files very quickly, to save 
and restore entire private and public disk devices at device 
speed, to handle user initiated backup of files, to restore 
the allocation tables for public disks after a system crash, 
to restore the allocation tables for a private disk pack after 
a crash which affected the pack, and to restore granule ac- 
count Information In the : USERS file. 



AUTOMATIC RECOVERY AFTER SYSTEM FAILURE 

The CP-V monitor performs consistency checks on the 
results of hardware operations, checks intermediate results 
of operating system software functions, performs checks and 
balances at appropriate interfaces between the operating 
system's modules, and monitors itself for unexpected trap 
conditions caused by the hardware or operating system soft- 
ware. A software check code is assigned to each type 
of failure that the monitor may detect. 

Some of these software check failures result in a momentary 
delay In service to all but the current user for whom the 
operating system is performing a service. In such case, 
the current user's job step is aborted, core is dumped to a 
file for later analysis and display, and normal operating 
then continues. The remaining software check failures are 
handled by the system's recovery routine. 

The recovery routine performs the following functions: 

1. Displays cause of failure. 

2. Takes a full core dump for later analysis. 

3. Closes all open files with default options. 

4. Packages or releases all partial symbiont files. 



5. Closes common TP journal if transaction processing is 
being used. 

6. Saves in-core transaction processing files. 

7. Packages error log. 

8.- Informs users of interruption. 

9. Saves time, data, error log pointers, accounting infor- 
mation, symbiont file directory, public disk granule 
usage map, and executive communication. 

10. Restarts system and restores items saved above. 

When functions cannot be performed, they are noted on the 
operator's console. If the function is considered minor, re- 
covery continues. If it is connected with file operations, 
the file identification is noted and recovery proceeds. 



The recovery routine described above occurs automatically 
with a minimum delay (a few seconds) in system availability. 
Operator initiation of this recovery function is also allowed, 
providing for the event that the system fails by not respon- 
ing to any operator key-in or user service request. 



When the recovery routine executes, it is independent of 
all monitor services and functions and requires only that a 
small recovery driver be intact in memory. This driver 
reads the main recovery module into memory from the system 
swap device, overlaying the pure procedure portion of 
CP-V. Certain monitor system tables are also required in- 
tact for successful recovery. These tables are verified 
before proceeding. If the recovery process cannot be com- 
pleted, the operator is instructed to initialize the system 
from the master system tape and restore files and backup 
tapes. 



CRASH ANALYSIS 

In the event of a recovery or single user abort, one of the 
recovery functions is to dump the contents of core memory 
into a special file in the :SYS account. This information is 
saved for later analysis by a system programmer using a 
special debugging program, ANLZ. 



The ANLZ program may be called by the operator or system 
programmers to run as a privileged ghost, on-line, or batch 
job. The ANLZ program is also called automatically 
as a privileged ghost job by the recovery routine as one 
of the first jobs following a recovery or the first job fol- 
lowing a single user abort. In any mode, ANLZ is command 
driven (except in the ghost mode following a recovery). 
It responds to commands that selectively display monitor 
tables, examine memory, and compare the dump with 
the running monitor. (Reference: Chapter 4.) 
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SYSTEM TAPE FORMAT 

A CP~V»system tape contains the following elements: 

1. Bootstrap loader. . 

2. Root for an absolute monitor. 

3. General Information record concerning this system 
tape. 

4. Other monitor segments (XDELT A, ALLOCAT, GHOST], 
FIX). 

5. Monitor overlay segments. 

6. RECOVER. 

7. Tape label information. 

8. Files for all system load modules and other needed files. 

9. Patches and GENMD commands. 

The genera! arrangement of the information on a master sys- 
tem tape is shown in Figure 5. 



b. A group of GENMp commands and GENMD patches 
to the processors .contained on the tape. 
•V * * 

5. A jEOD command (the final command of the patch 
deck). 

In addition^ there are two types of cards that may appear 
^anywhere within the patch deck (including the GENMD 
portion). These two types are the conditional patch control 
command and the comment card. 

No patch, command, or comment may contain more than 
72 characters of information. 

When the patch deck is read, it is retained by the system in 
a file called PATCH in the :SYS account. This file can be 
examined using the PCL processor. It may also be assigned 
toM:PATCH and DEFed onto the PO tape. 

The function and format of Delta format patches/ symbol def- 
inition patches, reconfiguration and partitioning commands, 
GENDCB commands, GENMD commands, GENMD patches, 
conditional patch control commands, and comment cards 
are described in the paragraphs that follow. 



PATCH DECK STRUCTURE 

Patch decks have the following structure: 

1. The following two types of patches: 

a. Delta format patches for the monitor root and its 
overlays. 

b. Symbol definition patches. 

The monitor root,patches can appear anywhere within 
the patch deck. The overlay patches must be in the 
same order as the system tape structure. Symbol defi- 
nitions must precede the patches in which the symbol 
is used . Patches to the reconfiguration processor must 
precede the boot-time reconfiguration and- partitioning 
commands and must be read from the card reader when 
thecard reader is used during boot-time for patching 
purposes . 

2. Boot-time reconfiguration and partitioning commands. 
These are optional, but if they are used, they must pre- 
cede the first overlay patch. It is also advisable to 
read them from the card reader. 

3. A card that contains an asterisk in column one. This 
card terminates the monitor patches and boot-time re- 
configuration and partitioning commands. 

4. The following two types of patches (which may appear 
in any order): 

a. A GENDCB command to assign the account, a 
password, serial number, and type of tape drive 
for the boot tape. 



DELTA FORMAT PATCHES 

Delta format patches are used to patch various segments of 
the monitor. The format of a Delta format patch is: 

[segname]/loc/value[(old value)]/comment 

where 

segname is the name of the segment to be patched. 
The current segnames and the order in which they 
must be patched are shown in Figure 6. 

If a segname is present, the loc field must represent 
a location in the corresponding segment or the loc 
field (and value field) must be null. The latter 
type of patch would have the format. 

segname// (the third slash is unnecessary) 

and must be the first patch with its particular seg- 
name. (An example of this form of patch is given 
in the 'Conditional Patch Control Commands' 
section below. ) 



Example: 

OPEN// START THE OPEN PATCHES 
OPEN/OPNH+.52/B PATCH/ 
/PATCH/LW.13 TABLES+.74/ 



24 Bootstrap and Patching Operations 




Note: 



Record sizes The tape bootstrap is 22 words long. Patch records are 20 words 

long. All other records are 512 words long. The figure indicates 
groups of such physical records. 

Head Head portion of load module. 

Data Protection type portion of load module. 

Patches Patches are included on the tape where shown if they exist in the 

file assigned to the M:PATCH DCB when DEF creates the system 
tape. The first group of M:MON root patches follows the Exec 
Delta data records. Any others are placed among segment patches 
according to their order in the patch file. The last record of each 
group of patches on the tape is the first patch for the next set of 
segment patches. The second through the last patch for a segment 
follow the segment to which they will be applied. GENMD patches 
follow the last of any patches following the RECOVER patches. 



Figure 5. Format of Master System Tape 
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****'*** * J * ft ******* * * t K * * 

C F "- V 
SYSTEM GENERATED ON: 
12:00 AUG 16, '74 
VERSION NO/ IS:' COO 



PATCH SEGMENT NAMES: 




(ROOT) 


Al.LOCATO 


(DATA) 


ALI.0CAT1" 


(PROC) 


FIXO 


(DATA) 


FIX2 


(DCBS) 


FIX1 


(PROC) 


GH0ST10 


(DATA) 


GH0ST12 


(DCBS) 


CH0ST11 


(PROC) 


CLOSE 


(DATA) 


DF.BUC 


(DATA) 


ENQOV 


(DATA) 


KEYIN 


(DATA) 


LDLNK 


(DATA) 


l.TAPE 


(DATA) 


MISOV 


(DATA) 


MPC9210 


(DATA) 


MPC9310 


(DATA) 


MULOV 


(DATA) 


OPEN 


(DATA) 


OPENTP 


(DATA) 


RMAOV 


(DATA) 


RTOV 


(DATA) 


STEPOVR 


(DATA) 


TP0V1 


(DATA) 


TP0V2 


(DATA) 


UMOV 


(DATA) 


RECOVER 


(DATA) 


*********************** 



Figure 6. Segment Patching Order 

If no segname is present, any location between 
10| o and FFFO] may be patched. Such patches 
may appear anywhere within the patch deck. 

loc is a Delta format symbolic location, possibly 

with offsets. 



value 
loc. 



is the Delta format value to be inserted at 



old value is the Delta format value of the previous 
contents of loc. 

Example: 

/IORT+.F8/PSM.9 TSTACK(PSM,6 TSTACK)/ FIX SIDR #6646 

If a patch command is in error (e.g., has an illegal char- 
acter, an incorrect old value, a value occupying more than 
one word, or an invalid loc value), it will be typed on the 
OC device. The operator must determine what was wrong 
and correct the problem. 

If the error is apparent from examination of the patch, it 
can be corrected and the boot process restarted. If desired, 
the system may be examined with Executive Delta, which 
is now in control and requesting commands at the operator's 
console. The patch in error may be corrected from the 
operator's console using Delta by entering the patch 



correction mode by keying-~i0(use right bracket (]©) on 
the Xerox 560) and then the correct patch in the form given 
above. After receiving the correct potch, the system re- 
sumes reading patches. 



PATCH BECK SYMBOL TABLES 

The Delta format symbolic values that are recognized in 
patches are assembled by the system tape definition proces- 
sor, DEF, from the REF/DEF stacks of the patchable modules 
using those items: 

\. Al! DSECT names. 

2. All DEFs ending in a colon(the colon is removed in the 
patch deck symbol table). 

3. The first UDEF after each CSECT unless a colon DEF 
intervened. 

4. Patch segnames. 

For M:MON only, all LDEFs are also included. The sym- 
bols obtained from MrMONand XDELTA are available to 
XDELTA at any time. Those from other modules are avail- 
able only while that module is being patched. DEF lists 
the symbols that are included as the fables are created. 

In addition, two special symbols are available during the 
patching process. 

The first is the symbol @ whose value is equal to the next 
available location in the patch area of the monitor. That 
is, it is initially equal to the monitor symbol, MPATCH, and 
its value is incremented by one each time a patch is encoun- 
tered whose loc field is equal to the current value of ^. 
The use of the special symbol @ frees the user from having 
to allocate space in the PATCH area of the monitor since 
Executive Delta will automatically relocate the patch area. 

Example: 

The following two potch decks are equivalent: 



/IORT+.F8/B (?/ 
/IORT+.FE/B @+l/ 
/0/LI.3 12/ 
/@/CB,3 5/ 
/@/BNE $+2/ 
/@/B I0RT+.F9/ 
/@/LI,3 0/ 
/@/B I0RT+.F9/ 



/IORT+.F8/B PATCH/ 
/IORT+.FE/B PATCH+1/ 
/PATCH/LI, 3 12/ 
/.+1/CB.3 5/ 
/.+1/BNE $+2/ 
/.+1/B I0RT+.F9/ 
/.+1/LI.3 0/ 
/.+1/B I0RT+.F9/ 



The second special symbol is @@ and is used when an even 
address in MPATCH is required. The only restriction on this 
special symbol is that @@ cannot be referenced while patch- 
ing @ (e.g., /@/@@/). The results are unpredictable. 
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Example: 



/MM+.64/TPSD.8 '<&/ 
/C<*3/>fM+. 65+4**287 
/("<>/. 17000000/ 



New symbols may be added to the symbol table by including 
symbol definition patches in the patch deck. Symbol def- 
inition patches must have the format 

' symbol = value 

where 

symbol is any Delta format symbol. (The symbol 
can be no longer than eight characters.) 

value is any evaluatable expression terminated by 
a blank. 



Example: 



#GRUNCH=.D87 
/GRUNCH/B GRUNCH+.20/ 
/.+1/B <?/ 
/@/LW,3 TABLES+3/ 

A3/CI,3 10/ 
/@/B GRUNCH+.50/ 



/55+.1E8/B JK/ 



In the above example, the patch at 55+.1E8 branches to 
the instruction CI, 3 10. 



RECONFIGURATION AND PARTITIONING COMMANDS 

These commands provide a means of reconfiguring the system 
and partitioning devices and/or controllers at boot-time. 
All of the commands begin with a colon (:) and must end 
with a period or a trailing blank by at least column 72. 
The commands may be specified in any order with the ex- 
ception of : END which must appear last (if it is used). 

If no reconfiguration and partitioning commands are speci- 
fied, the system responds as if the :GO command had been 
specified. 

Reconfiguration always validates the SYSGENed device ad- 
dresses. If a device address (ndd) is encountered for which 
the n cannot be validated, the following message is displayed 
on the OC device and the boot procedure is terminated. 



CANNOT CONVERT V IN 'yyndd' 



Three of these commands (:TYPE, fPART, and->REMQVE) 
contain the following parameter as port of rKe command 
format: ' 

value (sometimes referred" to as value 'and value_) 

The description of this parameter is quite detailed. To 
avoid repeating the description, several -times, it will be 
given here and references will be made back to this section 
in the command descriptions. 

The format of value is dependent on the CPU being used. 

For Sigma 6/7/9 systems, value must be in the format 

ndd 

where 

n represents a controller address and is specified as 
a letter. See Table B-2 in Appendix B. 

dd specifies the device number. See Table B-3 in 
Appendix B. 

For Xerox 560 systems, value may take one of two formats. 
The first format is 

ndd 

where 

n represents a cluster number and a unit number. 

See Table B-4 in Appendix B. 

dd specifies the device number. See Table B-3 in 
Appendix B. 

The second format consists of four hexadecimal digits which 
represent a hardware address in the format 



00 

FT 



C 

■nrrr 



u 

T-JTT 



dd 

1 t 1 8 l l tl } 13 U 'l? 



where n and ndd are defined in the following discussion and 
yy fs the device type. 



where 

c specifies the cluster number. 

u specifies the unit number. 

dd specifies the device number. 



'•GO This command specifies that the configuration speci 
fied on the system tape is to be used as is. The format of 
the command is 

:GO 

If :GO is specified, :TYPE and : REMOVE commands are not 
meaningful and the following message is output on the LL 
device: 



ALL :TYPE/ : REMOVE COMMANDS IGNORED 
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'.SAVE This command specifies that all device addresses 

not changed by :TYPE commands are fa remain as is,, except 
according to restrictions listed in the following description. 
The format of the command is 

:5AVf: Y ~ ' \_ '•:■ 

When the :SAVE command is specified, the following mes- 
sage is output on the LL device: 



**KEEP ALL DEV.ADDR.AS IS EXCEPT FOR :TYPE/ 
:REMOVE CHANGES 



When the :SAVE command is used, only those device ad- 
dresses which are different on the target machine from that 
of theSYSGENed system tape need be changed by the :TYPE 
command. All others remain as SYSGENed except when a 
:TYPE command redefines one or more device addresses for 
a specific device type where the SYSGENed IOP/controller 
or cluster/unit addresses are equivalent within the device 
type. In this case, every equivalent IOP/controller or 
cluster/unit address within that device type must be defined 
by :TYPE commands whether or not the device address needs 
to be changed or the undefined ones will be removed from 
the system. The :REMOVE command may also be used to 
remove SYSGENed devices. The :SAVE command must 
precede any other reconfiguration commands. 

I 
i 

When :SAVE is not specified, all device addresses must be 
specified by :TYPE commands unless no :TYPE commands 
ore used. Any SYSGENed devices for which addresses are 
not defined by :TYPE commands are removed from the sys- 
tem configuration (and cannot be returned to the system 
configuration without rebooting). 



:TYPE The :TYPE command defines a device type, its 

model number, and its new device address or addessses. The 
format of the command for single access device definitions 
is 

:TYPE device, value[, value!. . . 

and the format for dual access device definitions is 

:TYPE device, (value., value_)[, (value., value,.)]. . . 



device is a six character field. The first two char- 

acters specify the device type (e.g., CR) and the 
last four characters specify the device model num- 
ber in hexadecimal. 

value specifies the device address in the format de- 

scribed at the beginning of this section. The ^um- 
ber of addresses depends upon the number of devices 
of that device type whichore on the target machine 
or which need address changes (when :SAVE is. 
used). For dual access devices, value] specifies 
the primary path address and value2 specifies the 



alternate path address. When a device address 
change is required for' a specific device type, all 
addresses must be specified even if no change is 
necessary, or those not specified for the device 
type will be removed from the system. 

The model number is verified as a legitimate model number 
by searching the M-.MODNUM table. (See the SYSCON 
chapter in the CP-V/SM Reference Manual, 90 16 74.) 
When found, its corresponding controller model number is 
obtained from the M*.MODNUM table. Thedevice/controller 
model numbers are then used to check if this combination is 
the same as that which was originally SYSGENed for the 
given device. If not the same, all similar device/controller 
model number combinations in MrMODNUM are used for this 
validation. As an example, if M:MODNUM contains the 
following entries: 



Device Model 
Number 

7120 
7120 
7121 
7121 



Controller Model 
Number 

7120 
7121 
7121 
7120 



and the SYSGENed combination is 

7120 7121 

then the command :TYPE CR7121, .... will cause the fol- 
lowing device/controller combinations to be checked with 
the Indicated results: 



7121/7120 
7120/7120 
7121/7121 
7120/7121 



not valid 
not valid 
not valid 
valid 



SREMOVE This command removes device(s) or control- 

lers) from the system. Removed devices and controllers 
cannot be returned to the system without a cold tape boot 
creating a new file system. (If a device or controller is to 
be removed at boot time, but returned at a later time with- 
out changing the file base, the device or controller should 
be removed with :PART cards.) The format of the command 

is 

. (value ) f, value -i 

:REMOVE } CoNT/Va | ue j [,CONT,value| ... 

where 

value specifies the address of the device or control- 
ler to be removed in the format described at the 
beginning of this section. 

CONT specifies that a controller is to be removed. 
When a controller is removed, all devices on that 
controller are also removed unless the controller is 
dual access. When the controller is dual access, 
only the path specified by value is removed unless 
the o|her path to the device is already removed or 
. doesn't exist (i.e., single access within dual chan- 
nel). In the latter cose, all of the controller's 
devices are also removed. 

The number of devices or controllers that may be specified 
is limited only by the length of a card (80 characters). 
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In the following excmple, four disk packs were SYSGENed 
and the target system is to have only two disk packs, one 
public and one private. 

:TYPE DP7242,BF0,BF1,BF2 , 
: REMOVE BF1 



SYSGENed 
Disk Packs 



Result of 
:TYPE Command 



AFO - public BFO - public 

AFl - public BF1 - public 

AF2 - private BF2 - private 

AF3 - private removed 



Result of 
tREMOVE Command 

BFO - public 
removed 
BF2 - private 
removed 



:PART The :PART command specifies device(s) or con- 
trol ler(s) that are to be partitioned from the system. A de- 
vice or controller is partitioned as if it had been partitioned 
by the SYSCON processor and can be returned to the system 
via SYSCON without re-booting the system. (Refer to the 
SYSCON processor description in the CP-V/SM Reference 
Manual, 90 16 7 A.) This is useful when a system is being 
booted and a device which was SYSGENed to be part of the 
system is currently unavailable but will be available prior 
to the next system boot. COCs and Teletypes are not af- 
fected by this partitioning . The format of the :PART com- 
mand is 

:PART b^.._..Jr^ T ...... B ] ... 



jCONT, value ( [ r CONT /V alu e- 



where 



value specifies the address of the device or con- 
troller to be removed in the format described at 
the beginning of this section. 

CONT specifies that a controller is to be parti- 
tioned. When a controller is partitioned, all de- 
vices on that controller are also partitioned unless 
the. controller is dual access. When the controller 
is dual access, only the path specified by value is 
partitioned unless the other path to the device is 
already partitioned or doesn't exist (i.e., single 
access within dual channel). In the latter case, 
all of the controller's devices are also partitioned. 

A device partition request causes all devices which have 
identical device addresses to be partitioned. 

The number of devices or controllers that may be specified 
in the command is limited only by the length of a card 
(80 columns). 

Example: 

A system was SYSGENed to have four 9-track tape drives 
but two are down for maintenance when the system is booted, 

:TYPE 9T7322,A80,A81,A82,A83 
:PART A82.A83 



'.END The :END command defines the end of the set of 

reconfiguration and partitioning commands. The command 
is optional because the occurrence of either the first noriroot 
patch or an asterisk (*) command would also indicate the 
end of reconfiguration and partitioning commands. 

The format of the command is 

. :END 

When the end of reconfiguration and partitioning commands 
Is encountered, all :TYPE command definitions are pro- 
cessed first, then all :REMOVE requests, and finally all 
:PART requests. 

When all of the commands have been processed, a check is 
performed to determine if the original SYSGEN or the re- 
configuration for multi-unit controllers and their devices 
reside in non-conflicting input/output queueing channels. 
This means that an IOP/controller or cluster/unit in one 
queueing channel cannot have an equivalent IOP/controller 
or cluster/unit in some other queueing channel. The follow- 
ing error messages will identify all such conflicts and the 
reconfiguration process will then change the queueing chan- 
nels to be equivalent: 



****QUEUEING CONFLICT BETWEEN DCTiiANDDCT ]] 
QUEUE FOR DCTjj CHANGED TO THAT OF DCTii 



where 

ii is the DCT index for the first device. 

jj is the DCT index for a subsequent device . 

RECONFIGURATION AND PARTITIONING EXAMPLE 

In the following example, a CP-V system was SYSGENed 
for four different hardware configurations. These configura- 
tions are referred to as the 560X, 71, 70, and 7E. A set of 
reconfiguration and partitioning commands was generated for 
each machine with the set of commands for each machine 
being bounded by a conditional patch control command. 
The four sets of reconfiguration and partitioning commands 
exist in the patch deck. The one set that is to be used for 
a particular boot is selected by a set of conditional patch 
control commands such as the following: 

# 560X=0 

*7T=0 

'7D = 1 
# 7E =0 

The above commands indicate that the 7D machine is to be 
booted. Figure 7 lists the entire set of devices that were 
SYSGENed for this example. Figure 8 lists the set of recon- 
figuration and partitioning commands which were ignored 
because they were for machines not being booted. Figure 9 
lists the set of reconfiguration and partitioning commands 
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which were used in the boot process because the 7D was 
selected. Figure 10 lists the set of devices for the 7D con- 
figuration. This information is listed on the line printer 
during a boot, but not necessarily in the order shown in the 
Figures. All of the information listed in Figures 7/ 8, 9, 
and 10 is also entered into the system patch file, 

In Figures 7 and 10, DCT is the DCT index and CIT is the 
queueing channel's index. Also in these figures, when a 
device type (DEV-TYP) is a pooled device (i.e., dual ac- 
cess), the information for the alternate device is listed di- 
rectly below that for the primary device. The information 
is the same except that the DEV-TYP column contains 



the word "DUAL" and the DEV-ADR column contains the 
alternate device address. 



RECONFIGURATION AND PARTITIONING MESSAGES 

Table 5 lists the messages that may be output when recon- 
figuration and partitioning commands are being processed. 

When an error is encountered, the error message is preceded 
by a message containing a dollar sign ($) beneath the char- 
acter position in the command at which the error was found, 
Processing of the command in error is discontinued. 



*7D 
ISAVE 

••keep all dev.adcr.as is except for jtype/iremsve changes 

IREMeVE AOF 
IREM8VE A16 
1TYPE 9T7322,A80*A81 
? TYPE 0C7212/BF0 
IREM8VE C8NT*AF0 
IREM8VE CFl 
IREM8VE C8NTiAE0 
ITYPE DP7242/D80 
tTYPE ME76U,A05 
IEND 



Figure 9. Reconfiguration and Partitioning Commands that were Used 
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Figure 10. Device Resource Configuration for the Booted System 



Patch Deck Structure 



31 



Table 5. Reconfiguration arid Part itia^i^g Messages 



Message 


Description 


ALL :TYPE/:REMOVE COMMANDS IGNORED 


A :GO command has been specified/, :TYPE and :REMOVE 


•V " '.■.-■ 


commands are* not meaningful . ' 


**device / value CANNOT BE ADDED TO SYSTEM 


As the result of.tbe :TYPE command, the SYSGENed system and 
target machine ^evice/controller model number definitions are 




not equivalent. " This* message is preceded by a message containing 
a dollar sicfn (Sj-under the device type and also under the first 
device address for single access or the alternate device address 
for dual access devices. 




device - device type and model number. 




value - device address (in the format ndd described at the 
beginning of this section). 


- 


This message can also appear when there are more :TYPE defini- 
tions for the device type than allowed for in the SYSGENed 




system . < 


CANNOT CONVERT V IN Vyrdd' 


A device address was encountered for which the n in yyndd could 
not be validated. 


CANNOT PARTITION, CONT. ndd ALREADY 
PARTITIONED 


The controller specified on a :PART command has already been 
partitioned. 


CANNOT PARTITION, CONT. ndd NON- 
PARTITIONABLE 


The controller specified on a :PART command is not partitionable. 
(It is a controller for a Teletype, a RAD, or a COC, or it was 
defined at SYSGEN to be a non-partitionable controller.) 


CANNOT PARTITION, CONT. ndd NOT 
PRESENT 


The controller specified on a :PART command either does not exist 
or was removed in the reconfiguration process. 


CANNOT PARTITION, CONT. ndd NOT 
PRIVATE PACK 


A disk pack controller was specified on a :PART command and one 
or more of its associated disk pack spindles is public. Public disk 
pack spindles cannot be partitioned. 


CANNOT PARTITION, DEV. ndd ALREADY 
PARTITIONED 


The device specified on a :PART command has already been 
partitioned. 


CANNOT PARTITION, DEV. ndd NON- 
PARTITIONABLE 


The device specified on a :PART command is not partitionable. 
(It is either a Teletype, a RAD, or a COC, or it was defined at 
SYSGEN to be a non-partitionable device.) 


CANNOT PARTITION, DEV. ndd NOT PRESENT 


The device specified on a :PART command either doesn't exist or 
was removed in the reconfiguration process. 


CANNOT PARTITION, DEV. ndd NOT PRIVATE 
PACK 


Public disk pack spindles cannot be partitioned. 


CANNOT REMOVE, CONT. ndd NOT PRESENT 


The controller specified on a rREMOVE command either does not 




exist or was previously removed in the reconfiguration process. 


CANNOT REMOVE, DEV. ndd NOT PRESENT 


The device specified on a :REMOVE command either does not 




exist or was previously removed in the reconfiguration process. 


CONT. ndd PARTITIONED 


The specified controller has been successfully partitioned. 
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Table 5. Reconfigurgrion and Partitioning Messages (cent.) 



Message 



CONTINUATION ILLEGAL 



DEV. ndd PARTITIONED 



DUAL ACCESS DEFINED ILLEGAL nddj, ndd 2 



DUAL/SINGLE ACCESS MIXTURE 



INVALID TERMINATOR 



**KEEP ALL DEV. ADDR. AS IS EXCEPT FOR 
:TYPE/:REMOVE CHANGES 



NO RECONFIGURATION PERFORMED DUAL 

ACCESS DEFINITION CONFLICTS 
(ndd 1 [ / ndd 2 ]) / (ndd 3 [ / ndd 4 ]) 



**NO SPACE LEFT FOR CONFIG. INFO 



**PACK yyndd PARTITIONED, DIAL ndd 
NOT AVAILABLE 



**QUEUEING CONFLICT BETWEEN DCT ii 
AND DCT jj 

QUEUE FOR DCT jj CHANGED TO THAT OF 
OF DCT ii 



Description 



Continuation commands (i.e., commands containing a semicolon) 
are not allowed. 



The. specified device hai been successfully partitioned. 



On a :TYPE command, the primary address and the alternate ad- 
dress on a dual access device are equivalent. 



A :TYPE command specifies both single access and dual access 
device addresses; or the device type is for a single access device 
and the address is for a dual access device (or vice versa). 



A bad or unknown terminator terminates a field or option. Valid 
control command terminators are NEW LINE, period, carriage 
return, trailing blank, and end of control command image. 



A :SAVE command has been encountered. 



The :GO command was specified, or no : commands were spec- 
ified, or a :END command was specified by itself. 



A device address conflict has occurred as the result of :TYPE 
commands. Either a single access device address is the same 
as a primary or alternate address on a dual access device, or 
the primary address is the same as the alternate address on a 
dual access device. The ndds indicate the addresses involved. 
This message will appear twice for each conflict encountered. 

Too many :TYPE, :REMOVE, and :PART command definitions 
have been encountered. The total size of the infernal buffer 
which retains reconfiguration and partitioning commands is 
512 words. Each :PART and :REMOVE command requires one 
word, each :TYPE command for single access controllers requires 
two words, and each :TYPE command for dual access requires 
three words. Additionally, the buffer contains one control word. 
The buffer is needed to retain all control command information 
until every command has been processed. Actual processing of 
the commands takes place when the :END command, the first non- 
root patch, or an asterisk command is encountered. 



The device specified on a :PART command is a disk pack spindle. 



An IOP/controlIer or cluster/unit in one queueing channel has an 
equivalent IOP/controlIer or cluster/unit in some other queueing 
channel. The reconfiguration process will change the queueing 
channels to be equivalent. 



Patch Deck Structure 33 



Table 5. Reconfiguration and Partitioning Messages (cont.) 



Message - ' 


Description 


**TAPE yyndd PARTITIONED, DIAL ndd 
NOT AVAILABLE 

UNKNOWN COMMAND, FIELD, OR VALUE 


The device specified on -a :PART command is a tape drive. 

An unknown command, an invalid name, or a value field which 
contains too many characters, is not hexadecimal, or is not in 
the correct format for the particular machine was encountered. 
This message also appears for each reconfiguration and partition- 
ing command encountered after reconfiguration and partitioning 
processing has ended. It also appears when a :GO, :REMOVE, 
or :TYPE command is encountered after a :GO command has 
been processed and when a :SAVE command is encountered after 
a previous :SAVE command was processed. 



'.GENDCB COMMAND 

This command defines the system DCB associated with tape 
input during PASSO. This command is required only if the 
files are on a different tape than the boot tape or if they 
occupy more than one reel. If the command is not present 
in the patch deck, PASSO reads the account and serial num- 
ber from the tape and performs an automatic premount of 
the tape. No operator intervention is required. 

The format of the :GENDCB command is: 

rGENDCB (M : BI,account[, password]; 
:, (lNSN,value[, value]. . .),device) 



Example: 

:GENDCB (M:BI,ACCT1,PASS1,; 

:(INSN,001,002),9T) 

Any number of GENDCB commands may appear in the patch 
deck. Only the last will be applied. If it is defective, 
files will be copied from the boot tape. 

Any errors in the command are indicated by the message 

***GENDCB ERROR 

on the OC and LL devices. 



where 



M:BI specifies that tape input is to be through the 
M:BI DCB. No other DCB is valid for this 
command. 



account specifies an account identifier (up to eight 
alphanumeric characters) associated with the la- 
beled tape to be read during PASSO. 



password is the password associated with the labeled 
tape to be read during PASSO. The password (if 
any) must correspond to that specified when the 
tape was created, and may be up to eight alpha- 
numeric characters in length. 

INSN, value, ... specifies the serial number(s) (up 

to four alphanumeric characters in length) of the 
tape(s) to be read by PASSO. No more than three 
reels may be specified. The first reel specified 
must contain the first file to be read, and may be 
different from the reel used to boot the monitor. 



GENMD COMMANDS 

The GENMD commands are used in conjunction with the 
GENMD patches described below. The three GENMD com- 
mands are GENMD, LIST, and DELETE. 



GENMD This command indicates which file is to be 

patched next. A GENMD command must precede the set 
of patches for each file to be patched. Any number of sets 
of patches to the same file may be present, provided each 
is preceded by a GENMD command. The format of the 
command is 

GENMD filename 



LIST This command lists the patches currently in the file 
being patched and has the format: 



LIST 



device specifies a tape-type device code (e.g., 
9T, 71). 



DELETE When a file is patched, a record is kept of the 
list of patches to the file within the file itself. The DELETE 
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■command removes' Hits ihf of patches from the file (but does 
nor remove the effect of the patches on the file). The com- 
mand may be used to pnr.ent files from growing too large if 
they are not restored when applying a new patch deck. The 
format of the command is 

DELETE 



GENMO PATCHES 

GENMD patches are used to modify nonresident elements of 
the system. 

GENMD patches have the format: 

joe, value[, value]. . . [. comment] 



:GENMD [,segname] 
[segname], 



Old value is formatted in the same manner as 
value. If the old value specified is not the same 
as the actual old value, an error message will 
be issued. However, if the old value specified 
matches the (new) value specified, the message will 
be issued but the error will not be counted and pro- 
cessing of the patch will continue. • 

A GENMD command may be continued by terminating the 
first Vine with a semicolon (;). The semicolon must not di- 
vide a name or a hexadecimal string and is not permitted 
where a blank is required. The continuation line must be- 
gin with a colon (:) if the continued line began with 
:GENMD. Otherwise, the continuation line begins with 
the next character of the command. 



where 



segname specifies the overlay segment name to be 

patched. If not present, the most recently spec- 
ified segname is assumed. If not present and no 
segname was specified previously, the root seg- 
name is assumed . 

loc specifies the location to be patched and has the 
format [name] [±hex value]. The hexadecimal 
value is added to or subtracted from the absolute 
address of name. A maximum of eight characters 
may be used for the hexadecimal value. The name 
need not be defined in any particular overlay since 
all the stacks are searched. If more than one 
overlay defines the same name, the first is used. 
The special name @ refers to the start address word 
in the load module HEAD record. 

value specifies the value to be inserted at loc. If 
more than one value is specified, they will be in- 
serted at successive locations. Each value must 
have the format 

hex value[±name[±name]. . .] 

The absolute address of the names are added to or 
subtracted from the hexadecimal value. A max- 
imum of eight characters may be used for the hexa- 
decimal value. The name need not be defined in 
any particular overlay since all the stacks are 
searched. If more than one overlay defines the 
same name, the first is used. 

If a name needs to be referred to with other than 
word resolution, the standard format is permitted 
for byte, halfword, and doubleword resolution 
(e.g., BA(name)). 

Any value specification may optionally contain a 
replacement value check specification using the 
format 

value (old value) 



GENMD ERROR MESSAGES 

Table 6 lists the error messages that may be output when 
GENMD commands and patches are being processed. 



CONDITIONAL PATCH CONTROL COMMANDS 

A conditional patch control command specifies whether the 
patches that follow are to be used as patches or are to be 
effectively ignored. The conditional patch control com- 
mand controls the SKIP flag. When the SKIP flag is set, 
all subsequent patches are effectively ignored until the 
SKIP flag is reset. The conditional patch control command 
can appear any number of times and anywhere within the 
patch deck (including the GENMD portion). The command 
has the format: 

f[ya lue] 

where value is any well-formed, but not necessarily evalu- 
atable, expression terminated by a blank. The value expres- 
sion may contain an undefined symbol. 



If value contains an undefined symbol, is negative, or is 
zero, the SKIP flag is set. While the SKIP flag is set, only 
the segname field of a patch is examined to determine when 
the current segment's patches end. If value is absent or 
greater than zero, the SKIP flag is reset and normal patch- 
ing resumes. The special symbol ELSE may be used to toggle 
the setting of the SKIP flag . 



The SKIP flag is also changed when a Delta format patch 
that does not have a loc and value field is encountered 
(i.e., segname//). In this case, it is set if the segname Is 
undefined and it is reset otherwise. 
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Table 6. GENMD Error Messages 



, Message,. 


Description 


BADLMN-OOOO 


The file is nor a load module . 


BAD LMN - xxxx 


An error occurred when accessing the load module. The code and 
subcode are indicated by xxxx. 


BAD SEG 


A segname is not in the TREE. 


DLM AT xx 


The delimiter in column xx is not what it should be. 


**nn GENMD ERRORS DETECTED 


This message is output on the OC and LL devices at the conclusion 
of the GENMD patching process and indicates how many errors 
occurred. 


HEX AT xx 


The hexadecimal number ending in column xx is null, too large, or 
not hexadecimal. 


LOCATxx 


The location ending in column xx or whose value ends in column xx 
is not contained in the segment. 


NAME AT xx 


The name ending in column xx is null or is not in the load module's 
stacks. 


NO FILE NAMED 


A 'GENMD filename' command has not yet been encountered or has 




no filename on it. 


OLD + loc = value 


A replacement check error has occurred. That is, an 'old value' was 
specified which did not match the actual old value. The loc field 
specifies the location where the error occurred. The value field 
specifies what the actual old value in the location was. 


TOO BIG 


Not enough core is available to read the REF/DEF stack. It may be 
possible to do the patch if all names are converted to absolute hex- 
adecimal values, since the stacks are read only if a name is used. 
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Examples: 



PATCH FILE C BEATS ON 



1. The following patches will be included only if the sys- 
tem was generated for a large Sigma 9 or a large 
Xerox 560 . 

#:BIG 

/SWAPPER+.C5/B @/ 
/@/Ll,5 0/ 
/@/SLS,7 LI/ 
/@/B SWAPPER+.C6/ 



All patches read during the startup of the system (except 
GENDCB commands) are copied to the file PATCH in the 
system account. Those that were read while the skip flag 
was set appear with the word SKIP in columns 77-80. The 
resulting file may be used as input to DEF to create a sys- 
tem tape with, the complete, current patch deck on it. 



2. The following patches will be included only if the 
ENQ/DEQ feature was included in the system: 

ENQ// 

ENQ/ENQ0+.266/B @(CW,13 ENQP+.1F4)/ 

/@/LB,15 ENQP+.1F4/ 

/@/CB,15 13/ 

/@/B ENQ0+.256/ 

OPEN// 

3. The symbol BPS will be set to one if the system was 
generated for a pack swapper with greater than 128K. 
Otherwise, it will be set to zero. 

#:BIG*DPSI0 
#BPS=1 
#ELSE 
#BPS=0 



COMMENT CARDS 

Comment cards may appear anywhere within the patch deck. 
In the portion of the deck that contains Delta format patches 
and symbol definition patches, the comment card must con- 
tain a Mess than 1 character (<) in column one. In the 
GENDCB and GENMD portion of the deck, comment cards 
must contain one of the following in column one: 



SEQUENCE OF OPERATIONS 

The master system tape is loaded into the machine by use of 
the standard load procedure described in the CP-V/OPS 
Reference Manual, 90 16 75. The hardware bootstrap loads 
and enters the tape boot at the beginning of the system tape. 
This tape boot, in turn, loads the monitor root and the fol- 
lowing functions are then performed. 

If the system was generated with the BIG option on the 
:MON card and is not being booted on a Sigma 9 or Xerox 
560, the following message is output to the operator's con- 
sole and the bootstrap operation is terminated. 



SYSTEM REQUIRES SIG9 OR X560 



The operator's console (OC) device address is validated. If 
the actual OC device address is different than that of the 
SYSGENed address, the system will halt (wait). The oper- 
ator should enter the appropriate OC address into register 0. 



To enter the OC address on a Sigma machine: 
1. Put the machine in IDLE. 



2. Set the SELECT ADDRESS switches on the control panel 
to 0. 



3. Enter the appropriate device address into the SELECTed 
ADDRESS. 



4. Set the COMPUTE switch to the RUN position. 

To enter the OC address on the Xerox 560: 
1. Enter CONTROL P. 



2. Enter 0/ (which displays the contents of register 0) . 
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3. Enter the new device address followed by fhe letter M. 

4. Enter an X. (Thiswil! cause the 560 to resume processing.) 

After the OG address has been validated, the following 
message is output to the operator: 



ENTER ANY OF: . 


I 


= TTY I/O 


P 


= LP OUTPUT 


F 


= TAPE FILES 


S 


= :SYS FILES 


T 


= TAPE PATCHES 


C 


= CARD PATCHES 


D 


= X DELTA 



The operator must respond within 10 seconds by typing one 
or more of the characters above followed by new line or by 
entering new line alone. If new line alone or nothing is 
entered, T is assumed by default. If any characters other 
than those listed above are entered, they are ignored. 

The letters have the following meanings: 

I specifies that the operator wants to read and re- 

spond to the normal OC messages during the boot. 
Otherwise, default responses are assumed up to 
the date/time request (see below) and normal 
output is suppressed. (Error messages will still 
be output. ) ' 

P causes output to the LL device to occur. Other- 
wise, the printer is not used. 

F causes PASSO's tape copy operation to occur. 

Otherwise, a boot-under-the-files occurs. 

S causes the files to be copied from the POtape into 

:SYS without destroying the entire file system. 

T define that the patch deck(s) are to come from 

and tape or cards respectively. Either, neither, or 
C both may be specified. If both are specified, 

cards will be read first for root patches and last 
for overlay patches and GENMD commands. 
Card patches meant to repatch tape root patches 
should therefore be placed after a nonroot patch. 
Patches of the format segname// should be used 
in both patch decks to prevent the switching of 
devices from splitting up a logical patch. 

D causes Executive Delta to be retained after the 

boot for debugging purposes. 

N is meaningful only by itself and means "none of 
the above". 

The message 



NEW FILE SYSTEM 



indicates that F was specified. If F was specified, the old 
file system is not destroyed until the entire patch deck has 
been read. The bootstrap operation may be halted at any 
time during this interval by triggering a console interrupt. 
The message 



INITIALIZATION HALTED - RESTART O.K. 



indicates a successful halt. 

If I was specified and if the system includes fhe real-time 
option, the system then issues the following message. 



RESET RESDF YYY,XXXXX 



This message allows the operator to override the SYSGEN- 
defined values for the size of the RESDF area (dedicated 
real-time memory pages) and its starting address. The op- 
erator should respond: 

[yyy]{>xxxx]© 

where 

yyy is the optional decimal number of pages to be 

in the RESDF area; a value of through 999 may 
be used. 

xxxxx is the optional hexadecimal word address of 

the first page to be in the RESDF area. Any page 
address representing a value greater than or equal 
to 10,000] 6 (64K) may be used. 

If either or both optional parameter(s) are not specified, the 
SYSGEN-defined default(s) will be used. 



CP-V will then request the date 



DATE (MM/DD/YY) 



and the operator should enter the date (e.g., 2/5/74). 
Then CP-V will request the time 



TIME (HH:MM) = 



and the operator should type the time, which is represented 
by a 24-hour clock (e.g., 6:05 PM is typed as 18:05). The 
time of day is typed at the left margin of the console once 
every minute after the system has been initialized. The 
form of this type-out is 



hh:mm 



If the system is being loaded on a machine for which it was 
not SYS GE Ned, one of fhe following messages will be dis- 
played on the OC device and the bootstrap operation will 
be terminated. 
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SYSTEM NOT SYSGENED FOR SIGMA 6 



SYSTEM NOT SYSGENED FOR SIGMA 9 



SYSTEM NOT SYSGENED FOR XEROX 560 



If the system and target machines match and if I was speci- 
fied the following message is displayed: 



C/LL/DC ASSIGN OK (YES/NO) 



If the operator's response is YES or ©, it is assumed that 
the device addresses for the control device, listing log, 
and system device are not to be changed from those estab- 
lished when the monitor was defined. If the response is 
NO, then the following messages will be output to rede- 
fine these device addresses. 



CRndd =S> CR 




LPndd=>LP 




DCndd =3> DC 



where each ndd is the current device identification and as 
many DC messages are output as there are swap devices. 

In response to each of these messages the operator must type 
two or three characters. If two characters are typed, they 
must be 'SA* and indicate no change for this device. If 
three characters are typed, they must be the channel and 
device designation codes (ndd) defining the address of the 
indicated device (see Appendix B, Tables B-2 and B-3). 

If the DC or swapper assignment is incorrect, one of the fol- 
lowing three messages will be displayed. Two of the mes- 
sages request a new swapper device address. 



Hyyndd INOPERATIVE 
yyndd => yy 



(The device address is unrecognizable by the hardware.) 



! lyyndd NOT A dddd 
yyndd 4> yy 



(The dddd field specifies the model number that was expected 
as the swap device.) 



PSA TRACK FLAWED 



(The swapper disk pack contains flaws. The boot process 
terminates.) 

Before completing any of the above responses with a © or 
©, the operator may cancel the response by striking the@ 
key. Following this, or if a completed response is in error, 
the message 



99 



will be output and the key-in request will be repeated. 

If no characters are typed within 10 seconds, a © response 
is assumed. 

After all necessary responses have been received, the boot 
subroutine reads the system information record from tape 
and writes it on the LL and OC devices if Pand I are speci- 
fied, respectively. 

The following sense switch information is then listed on the 
OC device if I was specified. 



SET SENSE SWITCHES AND TYPE N/L 

SSW1 =>CHECKWRITE DISK WRITES 

SSW2 =>NO AUTOMATIC LOGON/LOGOFF 

SSW3 =>OPERATOR RECOVERY ON DISK BOOT 

SSW4 =>SYSTEM SECURITY CHECKING 



The system will continue when a NEW LINE or any other 
character is entered. 

Next, the reconfiguration and partitioning commands (if 
any exist) are read and processed. A summary of the 
system's device will be output on the LL device (even if 
no :TYPE commands are encountered). Permanently down 
devices are not listed. 

Next, the monitor patches are read and processed for the 
patching of the overlays, ALLOCAT, GHOST 1, and 
RECOVER. (If the RECNFIG boot-time processor needs to 
be patched, XDELTA performs the patching as it does for 
the monitor root. However, these patches must precede 
the reconfiguration and partitioning commands in the patch 
deck. ) 

After the nonroot patches have begun, reconfiguration and 
partitioning commands are illegal. If any such commands 
appear in the deck, the following message is displayed on 
the OC device (and also on the LL device if P was speci- 
fied) and the bootstrap continues. 



V COMMAND NOT IN PATCH DECK PROPERLY 



This message is displayed only one time, even if additional 
reconfiguration and partitioning commands are encountered. 



Sequence of Operations 39 



It then copies the overlays, etc.,' to the swapping device, 
communicating the sizes and disk addresses to the resident 
root of the absolute monitor. Control then passes to another 
boot subroutine at WRTROOT. This second boot subroutine 
causes the monitor root to be copied to the disk, preceded 
by a disk bootstrap. At Hi is paint, the resident monitor is 
operational but the system Has not yet been established on 
the resident swapping device. The GHOST1 processor 
performs this function.. '* 

If P was specified, GHOSTl determines whether any de- 
vices or controllers are partitioned. If none are partitioned, 
the following message is displayed on the LL device: 



NOTHING PARTITIONED 



However, if devices and/or controllers are partitioned, 
the following message is displayed on the LL device: 



***** ITEMS PARTITIONED **' 



followed by messages identifying each device or controller 
which is partitioned. The messages have the following 
formats: 



The hardware boot routine' loads' and transfers control to the 
disk boot which then loads the monitor root into core. The 
system requests the date and time and then asks 



DO YOU WANT DELTA (Y/N)? 



to determine whether the system debugger's memory should 
be released. 

The following message is then output to the operator's 
console: 



DO YOU WANT HGP RECONSTRUCTION (Y/N)? 



A response of Y causes an HGP reconstruction of the public 
file system to be performed. If no response is received 
within one minute, N is assumed. 

Partitioning information is displayed as described previously, 
and the system ghost jobs (Fill, ERR:FIL, and Fix) are 
started. Normal operation may then be resumed. 



DEV yyndd PARTITIONED 



(for devices) 



CONT yyndd PARTITIONED 



(for control lers) 

When all partitioned items have been identified, the 
following message concludes the list: 



** END OF PARTITIONED ITEMS ** 



When P was not specified or when GHOSTl has completed 
the above listing, GHOSTl starts the symbiont ghost, Fix 
ghost, ERRrFIL ghost, and fill ghost, and then exits. 



BOOTSTRAP I/O ERROR RECOVERY 

I/O error recovery during bootstrap is provided for the card 
reader, line printer, magnetic tape, and disk. However, 
error recovery is not possible until the tape boot and mon- 
itor root have been read from tape. The following error 
messages may appear on the OC device: 



! ! yyndd INOPERATIVE 



! lyyndd ERROR. TIO value, TDV value, 
CMD-loc 



! lyyndd CKWRT ERROR, TIO=value, TDV^value, 
CMD=loc 



! lyyndd WRITE PROTECTED, SEEK=va!ue 



I lyyndd MANUAL MODE 



BOOTING FROM DISK 

Once the operating system has been bootstrapped from tape, 
it may thereafter be brought into core from the disk by 
means of the load procedure described in the CP-V/OPS 
Reference Manual, 90 16 75. 



where 

yyndd 
value 



CHECKWRITE ERROR 



is the address of the device with trouble, 
indicates the TIO or TDV results or the SEEK 



address . 
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When any of the first four messages above occurs, the wait 
state is entered. To continue, the operator must place the 
CPU into IDLE; STEP, and then RUN sfaie. The I/O will 
then be retried ► If the last message above occurs, I/O will 
continue when the condition h corrected. When an error 
occurs for a magnetic tape or disk operation, the operation 
is retried ten times before an error" message is ot put. 



PASSO reads a tape specified by the user (via the GENDCB 
command) which contains the nonresident elements of the 
system (i.e., CO, processors, libraries, etc.). {This j s nor- 
mally the labeled portion of' the tape used to bootstrap the 
absolute monitor.) PASSO allows the user to modify these 
elements via the GENMD portion of the deck. 



PASSO PROCESSOR 

The PASSO processor performs various system initialisation 
functions and is entered automatically whenever a CP-V 
Itape is booted. 



PASSO MESSAGES 

The messages in Table 7 may be output by the PASSO 
program on the LL device. PASSO continues its normal 
operation. 



Table 7. PASSO Messages 



Message 


Description 


***CANNOT BOOT LMN 


A load module cannot be read from the bootstrap tape because 
core is not large enough. PASSO outputs the filename in error 
and continues to the next file, thus ignoring the file in error. 


I/O ERR/ABN nn,xxxING FILE ffffffff ON dddd 


An I/O error or abnormal condition has occurred on tape or 
disk. 

nn is the error or abnormal code. 

xxx is READ, WRITE, OPEN , or CLOS. 

ffffffff is the current filename. 

dddd is TAPE or DISC. 

PASSO continues after this message. 
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MONITOR DUMP ANALYSIS PROSRAM 



INTRODUCTION 

The monitor dump analysis program ANLZ (Analyze) is 
designed to aid in the debugging of CP-V crash dumps. 
ANLZ operates in the ghost, on-line, and batch modes. 
It accepts as input any tape or disk dump produced by the 
recovery procedure and any tape dump produced by exe- 
cutive Delta. If a tape is input, the ANLZ user must sup- 
ply the tape type in response to the message 



ENTER TAPE TYPE: 71, 9T, BT, ETC., 



Tape input results in the creation of a disk file (CP5DUMP); 
subsequent tape inputs replace the contents of this file. 



GHOST MODE 

ANLZ is called automatically by the recovery procedure, 
and functions as a ghost job to interpret and summarize crit- 
ical monitor tables and to dump the monitor's dynamic data 
area. When ANLZ is initiated after a system crash, it 
neither looks for nor accepts any commands, operating en- 
tirely on default options. It assumes an INPUT command 
option of LAST; if unable to open the last MONDMP file, 
it then assumes an INPUT command of TAPE. (Refer to the 
description of the INPUT command in the following text.) 
When Analyze is run in this manner, the output is an ab- 
breviated form of the output produced by the ALL display 
command. 

ANLZ is also automatically initiated after a single user 
abort. In this case, it functions Just as though it had been 
initiated as a ghost job via an operator key-in. (This is 
described below. ) 

ANLZ may be called as a ghost job by the operator to 
examine the tape produced during an irrecoverable crash. 
The operator key-in used for this purpose is 

GJ OB ANLZ 

ANLZ then asks the operator for a command: 



ANLZ: ENTER COMMAND, N/L SAYS TO DO ALL 



The operator may respond with one of the following 
commands: * 

NO - just exit. 

TA - read a recovery-built tape. 

ME - run interactively from the operator's console. 



CP - read the CP5DUMP file. 

1-7 - read the indicated MONDMP file. 

? - list the ANLZ commands on the line printer. 

N/L (new line alone) - do default ghost run. 

In the interactive ghost mode, a key-in of 

INT, id 

will cause termination of the current ANLZ operation and 
a prompt for input, (id specifies the ANLZ user's number.) 

BATCH AND ON-LINE MODES 

Any batch or on-line user may call ANLZ by specifying 
the name of the program." For on-line users, this program 
name is entered in response to a TEL prompt for com- 
mands, as follows: 

IANLZ ® 



Any user, in batch or in on-line mode, must have the proper 
privilege level (80 or better) to examine the monitor. If 
not, ANLZ outputs the following message 



xx PRIVILEGE LEVEL NOT HIGH ENOUGH 



where xx is the user's current privilege level. (Response 
messages are output on the line printer for a batch user.) 

When accessed on-line, as an interactive ghost, or as a 
batch job, ANLZ is completely command-driven. It re- 
sponds to commands that selectively display monitor tables, 
examine memory, and compare the dump with the running 
monitor. 

An on-line user may terminate a display by depressing the 
BREAK key. 

COMMANDS 



When ANLZ is first entered, it responds 



ANALYZE HERE 



and, if in on-line mode, it requests entry of an input com- 
mand with the prompt character 
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All commands, options, and output are identical for batch, 
interactive ghost, and on-line modes. 



INPUT COMMAND 

INPUT The INPUT command directs ANLZ to input 

from a particular disk or tape file, or to open a file. The 
format of the command is 

IN[PUT]option 

where option may be any one of the options shown in 
Table 8. 

After reading a tape or disk file as directed by the INPUT 
command, ANLZ informs the user of the size of the file 
with the following message: 



THE LAST PHYSICAL PAGE IN THE FILE IS xx 



If in on-line mode, it then prompts (<)for the next command. 



Table 8. INPUT Command Options 



Option 


Meaning 


TA[PE] 


Directs ANLZ to read a tape created 
by the recovery process and to write it 
into the file CP5DUMP which is then 
used for input. 


CP[5DUMP] 


Directs ANLZ to open the CP5DUMP 
for input. 


LA [ST] 


Directs ANLZ to open the last file 
formed by the recovery procedure for 
input. (ANLZ must look at the run- 
ning monitor to obtain this information.) 


number 


Directs ANLZ to open a crash file 
formed by recovery. Recovery file 
names are of the form 

MONDMP(number) 

where number is the number of the dump 
file (1 forthe first dump since a "cold" 
start, 2 for the second, and so on). 



DISPLAY COMMANDS 

Three display commands may be used to output information 
from crash dumps. They are 

DISPLAY 

RUN 

ALL 



DISPLAY The DISPLAY command outputs information 

existing at the time of the crash. The format of the com- 
mand is 

DI[SPLAY] option 

where option specifies the information to be displayed 
(Table 9). 



RUN the RUN command outputs various linked lists of 

the monitor by running through the list and displaying each 
entry. The format of the RUN command is 

RU[N] option 

where option specifies the list to be printed (Table 10). 



ALL The ALL command performs all of the functions of 
the display commands described above and the functions of 
ANLZ (except dumps) when it is initiated by the auto- 
matic recovery procedure. The format of the command is 

AL[L] 

A numerically and alphanumerically sorted monitor map is 
output at the end of the ALL display. 



INTERACTIVE MONITOR DISPLAY COMMANDS 

Commands in this group allow the user to examine either 
the dump or the running monitor. Both the monitor and 
user JIT and physical core may be examined. The com- 
mands are 

loc 

loc^loco 

Line feed (or carriage return) 

t 



MONITOR 



loc = value 



loc The loc command outputs the contents of the speci- 

fied location. The format of the command is 



where loc is one hexadecimal value (1 to 8 hexadecimal 
digits) or two hexadecimal values separated by an operator 
indicating addition (+), subtraction (-), multiplication (*), 
or division (%). Note that loc values do not require a pre- 
ceding delimiter character ". ". 
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Table 9. DISPLAY Command Options 



t -■ '• ■■ - 

Option 


Meaning ' ; ' 


AJ[ITS] 


Displays JIT, AJIT, and context area of all incore users at the time of the crash. 


AT[ABLES] 


Displays the incore portion of ALLOCAT's tables* 


AV[R] 


Displays the tape and disk- labfes. •_,* 


CI [TS][ f index]... 


.Displays' the. requested entries of the Channel ^formation Table. Up to 20 entry 
indexes, -may be specified. If no iridex is specified, the entire Channel Informa- 
tion Table is displayed. 


CO[C][, index]... 


Displays the requested entries of the COC table. Up to 20 entry indexes may be 
specified. If no index is specified, the entire COC table is displayed. 


cu[n] 


Displays the current user's JIT, AJIT, and context area. 


DC[T|[,index] . .. 


Displays the requested entries of the Device Control Table. Up to 20 entry indexes 
maybe specified. If no index is specified, the entire Device Control Table is dis- 
played. 


EL[OG] 


Displays and validates the incore error log buffers. 


FM[, index] . . . 


Displays the requested entries of the file management read-ahead tables. Up to 
20 entry indexes may be specified. If no index is specified, the entire set of file 
management read -ahead tables are displayed. 


FQ 


Displays the Free I/O Queue ing tables. 


IO[,chan]... 


Displays the device on .the requested I/O channel. Up to 20 channels may be 
specified. If no channel is specified, the devices for all channels are displayed. 


I Q[, index].. . 


Displays the requested entries of the I/O queueing tables. Up to 20 entry indexes 
may be specified. If no entry index is specified, the entire set of I/O queueing 
tables are displayed. 


JIT[,id][,locl,loc2] 


Displays the contents of the JIT for the user specified by id. Loci and loc2 specify 
that only a portion of the JIT page is desired and represent a relative offset into the 
page in hexadecimal. If an id of is given or if no id is specified, the monitor's 
JIT is displayed. 


MR[,locl,Ioc2] 


Displays the requested portion of the monitor's root. The displacements (loci and 
loc2) must be absolute hexadecimal addresses. If no displacements are given, only 
the monitor's data area will be dumped. 


OJ[lT] 


Displays all of the out of core JITs at the time of the crash. 


OS 


Displays the user outswap tables (if outswap is in progress). 


PA[RTITlONS][, index]... 


Displays the requested entries of the partition tables. Up to 20 entry indexes may 
be specified. If no index is specified, the entire partition table is displayed. 


pf[ile] 


Displays the patch file that was created last. 


PM 


Displays the contents of the page matrix identifying the owners of all pages. This 
option assumes that page identifying routines (such as RUN USERS, RUN PROCS) 
have been run previously. 


PN 


Displays the processor inswap tables (if inswap is in progress). 
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Table 9, DISPLAY Command Options (cont. ) 


Option 


Meaning 


PP,pageno[, locl,loc2] 


. .Displays the contents of the indicated physical page. Loci and loc2 are relative 
page offsets expressed >n decimal (0 s -512). If they are specified, only the portion 
of the page in the indicated range is displayed. 


RA[T] 


'Displays the resource allocation tables. 


RB[T] 


^Displays the remote batch tables (lifVtere ate- any). 


registers] 


Displays the software check code, software check message, and the first two 
register blocks at the time of the crash. 


rc[xt] 


Displays the area of memory occupied by the recovery routines. 


RQ 


Displays the resource subqueue lists. 


ST[ABLE] 


Displays the output symbiont tables. 


sw[apper] 


Displays the contents of the swap/swap scheduling tables. 


sy[mbiont] 


Displays the contents of the RBBAT recovery file. 


TP 


Displays the transaction processing tables (if there are any). 


tr[aps] 


Displays the contents of the trap and interrupt locations. 


TS[TACK]L!d] 


Dumps the temp stack of the user indicated by id. If no id is specified, the 
monitor's temp stack is dumped. 


US[ER][;d]... 


Displays the user tables of the specified users. Up to 20 users may be specified. 


VP, pageno[, loc 1, loc2j 


Displays the contents of the specified virtual page. Loci and loc2 are relative 
page offsets expressed in decimal (0-512). If they are specified, only the portion 
of the page in the indicated range is displayed. 


WHY 


Displays the software check code and the software check message. 



Table 10. RUN Command Options 



Option 


Meaning 


mo[nitor] 


Specifies monitor pages. 


PR[OCESSOR][,{na m J 




Specifies processor pages or specific processor. The default is S, indicating all 
processor pages. 


RT 


Specifies real-time page chains. 


st[ate] 


Eft}] 


Specifies state queues. The number of a specific state queue may be specified 
(q^), or S indicates all. The default is S. 


US ^ E 4^D^-}] 


Specifies user pages for all users (S), or for particular users (id). Up to 20 users 
may be specified. The default is S. 


xd[elta] 


Specifies XDELTA's page chains. 
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Sec-? ,Sf>C2 This command outputs- five contents of tire 

memory locations between locj and loc2« The format of 
the command is 

lac-i, loc^ 

where loc: is a hexadecimal number or an expression indi- 
cating a sum or difference of two hexadecimal numbers. 

Two levels of loc; commands may be joined by the +, - 1 -, *, 
and % (division) operators. For example, the following are 
permissible: 

loc + loc., loc„ 

loc - loc., loc_ 

loc , loc~ + loc 

loc., loc. - loc 

loc. + loc_. !oc„ - loc . 
1 2 o 4 

loc. * loc«, loc_ % loc . 



■ (OC = value . This command places the specified value into 
the specified location (loc) of the running monitor. (The 
display mode must be on.) The format of the command is 

loc = value 

where 

loc is the specified location. 

value is the specified value. 



MAP COMMANDS 

These commands turn the map mode on and off. They work 
only with interactive commands and apply only to a partic- 
ular user. The two map commands are 

MAP 

UNMAP 



The resultant dump suppresses identical lines and an * is 
inserted next to the line number following the identical 
line encountered. An EBCDIC translation is included to 
the right of the dump. 



LINE FEED The line feed (or carriage return) character 

may be used in conjunction with loc and loc-i, I0C2 com- 
mands to dump the contents of the next location. 



MAP The MAP command loads the map of the specified 

user if his JIT is in core. The format of the command is 

MA[P],id 

where id is the user identification assigned by the system. 
Dump output following a MAP command is assumed to be 
virtual addressed. 



t This command may be used in conjunction with the 

loc and loci, I0C2 commands to dump the last location. 
The format of the command is 

I 



UNMAP The UNMAP command turns the mapping mode 

of operation off. The format of the command is 

UN[MAP] 

Dump output following an UNMAP command is assumed to 
be physical addressed. 



* This command may be used in conjunction with the 
loc and loc], I0C2 commands to dump the location whose 
address is contained in the location specified by loc. The 
format of the command is 



SEARCH COMMANDS 

Commands in this group allow core to be searched. The 
commands are 



MONITOR The MONITOR command turns the monitor 

display mode on and off (as does any explicit command). 
When the display mode is on, the current monitor is dis- 
played. When the display mode is off, the dump is dis- 
played. The format of the command is 

mo[nitor][di[splay]] 

where DISPLAY turns the monitor display mode on. Omis- 
sion of DISPLAY turns the monitor display mode off. 



COMPARE 

SMASK 

SEARCH 



COMPARE The COMPARE command compares dump lo- 

cations between loc] and Ioc2 with the running monitor, 
and outputs locations with nonequal contents. The format 
of the command is 



CO[MPARE], loc jjcx^ 
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SMASK The SMASK command sets the mask to the 

'specified value. The format of the command Is 

SM[ASK], value 

where value is a hexadecimal mask. 



PRINT '■ The PRINT command closes the output symbiont 
file to allow output to the line printer without requiring a 
return to' TEL. The format of. the command is 

PR[INT] 



SEARCH The SEARCH command searches for and outputs 
all words between locations loc] and I0C2 that contain the 
specified value under the mask. The format of the com- 
mand is 



SE[ARCH] / value / loc.,loc« 



where 



value is a hexadecimal value. 

locj is the beginning location and may be a hexa- 

decimal number or an expression indicating a sum 
or difference of two hexadecimal numbers. 

loco is the ending location and may be a hexadec- 

imal number or an expression indicating a sum or 
difference of two hexadecimal numbers. 



OUTPUT COMMANDS 

I 

Commands in this group direct or format the output of 
ANLZ, Four output commands are provided: 

ROWS 
LP 
UC 
PRINT 

ROWS The ROWS command establishes the width of dump 

output. The format of the command is 

ROWS value 

where value is a number between 1 and 12. ROWS 1 would 
cause all hexadecimal dumps to be one word wide; ROWS 8 
would cause the dumps to be eight words wide. (Platen 
width may need to be extended at ROWS = 8. ) 

'LP The LP command directs output from ANLZ to the 
line printer. The format of the command is 

LP [rows] 

where rows indicates the dump width in number of words. 

UC The UC command directs output from ANLZ to the 

on-line terminal. The format of the command is 

UC [rows] 

where rows indicates the dump width in number of words. 



DEBUG COMMANDS 

Commands in this group permit the use of Delta to facilitate 
monitor debugging. The three debug commands are 

BF 

DELTA 

NO DELTA 



BF The BF command specifies the name of the boot file 
that represents the monitor being examined by ANLZ. 
This enables the debugger Delta to read in the required 
symbol tables. If the BF command is not specified, the file 
M:MON in :SYS is the boot file that is assumed by default. 

The form of the command is 

BF fid 

where fid is the file identification and is in the form 



name 



h 



[account] . password] I 
account J 



DELTA The Delta command associates the debugger 
Delta with ANLZ and gives control to Delta. If the 
BF command has been issued, the Delta command ;S loads 
the global symbol table of the monitor root from the spe- 
cified boot file. The Delta command name ;S loads the 
local symbol table of the module named. If the BF com- 
mand was not executed, the file M:MON in :SYS is used 
to obtain the monitor symbol tables and the Delta com- 
mands apply to the running monitor being examined, not 
to the monitor in the boot file. The Delta command ;G 
is used to exit from Delta and to return control to ANLZ. 

The form of the DELTA command is 
DE[LTA] 



NODELTA The NODELTA command disassociates the 

debugger Delta from ANLZ. The form of the command is 



no[delta] 
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IfSCELLAKEOUS COMMANDS 



SPY C0&MA8D 



SYMBOLS* • This command creates an aiphanumerically 
sorted monitor roap' by reading, sorting, and formatting the 
monitor's REF/DEF stack in the file MONSTK. :SYS. 

The form of the command is 

SY[MBOLS}[fid] 

where fid is used to select symbols from a file and has the 
format 

[[". account!. password! 
L ^ J 

.account J 

MONSTK. :SYS is the default. 



IS This command reads the sorted symbol table that was 

saved the last time ANLZ ran as a ghost job. The command 
produces no output. When the IS command is used, the 
SYMBOLS command is unnecessary. The format of the IS 
command is: 



IS 



SYMBOL/ The symbol/ command displays the contents of 
a monitor location. The format of the command is 

symbol/ 

where symbol specifies the name of a location in the 
monitor. 

Note: The symbol table must have been retrieved by use 
of the SYMBOLS or IS command prior to use of this 
command. 



DUMP This command causes a specified range of ad- 

dresses to be dumped. The command's format is 

DUMP loc .Joe- 
Dump output following a MAP command is assumed to be 
virtual addressed; after an UNMAP command, physical 
addressed. 

CLOSE This command causes the input dump fife to be 

closed. The format is 

CLlOSE] 

A user should close a file prior to entering the monitor dis- 
play mode. 

HELP This command lists all ANLZ commands and op- 

tions, and gives a brief description of the purpose of each. 
The form of the HELP command is 

HE[LP] 



SPY SPY provides a mechanism for obtaining information 

about users currently in the system. If the ANLZ user has 
the proper privilege (i.e., CO or above), SPY will read the 
selected set of- user JITs from the swap device and output 
them on the LO device (i.e., on the LP or UC). If the 
ANLZ userdoes not have sufficient privilege to allow direct 
I/O, SPY will try to obtain the selected user JITs from in 
core, rjowever, it is unlikely that SPY will be able to 
capture "trie JITs of more than a few users at best. 

The format of the command is 

SPY [option] 

If no option is specified, all user JITs will be read. The 
options are: 

SWAP reads all user's JITs on the swap device. 

^L,*J. • • reads the JITs of the specified users. 

SWAP *[,*]. . . reads the JITs of the specified users 

from the swap'Uevice. 

SNAP #[, #]. . . SNAPs the selected JITs. 

In general, users are specified by their user numbers. How- 
ever, batch IDs can also be used. 

The SNAP option causes the JIT to be output in the usual 
SNAP format. All other SPY output has the column headings 
listed in Table 11. 





Table 11. SPY Output 




Column 


Description 


USER 


B - batch job. 

O - on-line user. 

G - ghost job. 

* - JIT read from swapper. 




ACCOUNT 


The user's account number. 




NAME 


The user's log-on name. 




PRV 


The user's privilege level. 




PR1 


The user's current priority. 




PRB 


The user's base execution priority. 




LN/ID 


The user's line number if on-line, 
user's SYSID and partition number 
batch. 


The 
if 


STATE 


The user's current state. 
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Table 1 1. SPY Output (cont. ) 



Column 


Description 


PSIZ 


The user's peak si?e In decimal number 




of pages. 


PCT 


The user's current page count in-', * 




decimal. 


CCBUF 


The last control card read or the Ib'st 




on-line command that TEL read. 


CPU - SEC 


The number (in decimal) of seconds the 




user has been in core. 


REM - SEC 


The number (in decimal) of seconds the 




user has left to run in core. (Valid for 




batch jobs only. ) 


CAL - CNT 


The number (in decimal) of CALs the 




user has issued. 


DISCAC 


The number (in decimal) of RAD and 




disk accesses the user has performed. 


TAPEAC 


The number (in decimal) of tape ac- 




cesses the user has caused. 


APS 


The j number (in decimal) of I/O ac- 




cesses per CPU second for the user. 


CPS 


The number (in decimal) of CALs per 




CPU seconds for the user. 


PG - CNT 


The number (in decimal) of line printer 




pages that the user has printed. 



EXIT CQMPMftfD 

END The END command causes an exit from ANLZ. 

The format of the command is 

en[d] 



OUTPUT 

The output produced by ANLZ consists of displays of for- 
matted monitor and user tables and the contents of registers 
existing at the time of the crash. The time and date infor- 
mation in the output page headings refer to the time at 
which the crash occurred. 

Some of the output tables are chain type displays. That is, 
they are formed by starting at the head of a chained list and 
outputting that list until the tail of the chain is reached. If 
the tail and the last page in the chain do not agree, the fol- 
lowing message is output: 



TAIL ERROR 



If the count differs from the number of pages in the chain, 
the following message is output: 



COUNT ERROR 



Table 12 lists all of the ANLZ displays in order of appear- 
ance in the ANLZ dump. The left-hand column specifies 
the heading that appears at the top of each display. The 
right-hand column describes the contents of the display. 



Table 12. Displays 



Heading 


Contents 


REGISTERS: 


The contents of the registers at the time the dump was taken. 


TRAPS/INTERRUPTS: 


The output for trap and interrupt locations. The trap and interrupt locations 
are those used by the associated XPSD instructions and are listed in 
Table 13. 


PAGE IN WHICH TRAP OCCURRED: 


The core page in which the trap occurred, if a trap was the cause of the 
recovery. 


USER TABLES: 


The user tables. This display includes the tables associated with each 
user that has a page chain. The meaning and source of items in this dis- 
play are defined in Table 14. 


ADDITIONAL USER TABLES: 


The remainder of the User Tables display above. The meaning and source 
of items in this display are defined in Table 15. 
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Table 12. Displays (cont. ) 


Heading 


Contents 


USER STATE CHAINS: 


The user state chains which indicate the state of each user in the system. 


RESOURCE WAITQUEUES: 


Ike queues of users waiting for resources. The queues are listed and de- 
fined in Table 16. 


SWAP TABLES: 


The swap tables. The meaning of each location in the table is defined 
in Table 1.7. 


PARTITION TABLES: 


The partition tables. Table 18 defines the headings in this display. 


PROCESSOR TABLES: 


The processor tables. Table 19 defines the headings in the display. 


MONITOR (FREE) PAGE CHAIN: 


The monitor free page chain. The swapper page chain is formatted in the 
same manner as this display. Usually there is no page chain data 
output. 


USER PAGE CHAINS: 


The user page chain display. This display indicates which pages and how 
many pages were being used by the various users resident in core. 


PROCESSOR PAGE CHAINS: 


The processor page chain display. This display indicates which pages and 
how many pages were being used by the various processors resident in core. 


i 
READ AHEAD TABLES: 


The read-ahead tables. 


REAL TIME PAGES: 


The real-time page chain. 


XDELTA/HANDLER PAGE CHAINS: 


XDELTA's page chain. 


PHYSICAL MEMORY ALLOCATION: 


The actual physical memory allocation on a page-by-page basis. This 
display is a composite picture of the monitor free page chain, user page 
chain, and processor page chain displays, plus the resident monitor and 
its JIT, plus any unallocated pages. 


ALLYCAT TABLES: 


The ALLOCAT buffer adjustment tables. The headings used in this 
display are defined in Table 20. 


UNALLOCATED PAGES: 


The contents of any unallocated pages. 


I/O CHANNEL DEVICE STATES: 


The I/O channel and device states. The display is separated into tables 
pertaining to each logical channel. For each channel, ANLZ prints the 
channel information table (CIT), the device control tables (DCT) for de- 
vices on the channel, and the user I/O request queues on those devices. 
Table 21 defines the headings used in the display. 


FREE QUEUE ENTRIES: 


The free queues entries which are used to contain user I/O requests for 
I/O devices defined in the I/O Channel Device States display above. 


CHANNEL INFORMATION TABLE: 


The channel information tables (CIT). 


DEVICE CONTROL TABLES: 


The device control tables (DCT). Table 22 defines the meaning of the 
headings used in this display. 
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Table 12. Displays (cont.) 


Heading 


Content's 


IOQ TABLES: 


The IOQ fables. Table 23 defines, the meaning for the headings used in 
the IOQ tables display. 


COC TABLES: 


The COC tables. This display includes the line table values for those' 
lines having an associated user (determined by a non-zero value tn 
LB-.UN). Table 24 defines the headings used in the COC tables display. 


RESOURCE ALLOCATION TABLES: 


The resource allocation tables. 


AVR TABLES: 


The AVR tables. Table 25 defines the headings used in the AVR tables 
display. 


IN CORE ERROR LOG DATA: 


The contents of the incore error log buffers. 


OUTPUT SYMBIONT TABLES: 


The output symbiont tables. The headings used in this display are 
defined in Table 26. 


*** ASSIGNED CPOOLS: 
*** AND THEIR SPOOLS: 


The contents of the assigned CPOOLs and corresponding SPOOLs. 


MONITOR JIT: 


The monitor JIT contents and the monitor TSTACK contents. TSTACK 
headings are defined in Table 27. 


CURRENT USER: j 


The current user's JIT. 


CONTENTS OF TSTACK: 


The current user's TSTACK. TSTACK headings are defined in 
Table 27. 


ADDITIONAL JIT FOR USER # nn: 


The current user's AJIT (additional JIT). 


CONTEXT AREA FOR USER # nn: 


The current user's context area. 


*** PHYSICAL PAGE # nn: 


The current user's physical pages. 


MONITOR ROOT: 


The monitor root. 


RBBAT RECOVERY FILE: 


The RBBAT recovery file, which includes ghost communication buffers, the 
RBBAT environment, the RBBAT static data, and the RBBAT dynamic data. 
(Usually there is no dynamic data output.) 


USER IDENTIFICATION: 


The user identification. This display is a composite of all JITs in the 
MONDMP file. 


PATCH FILE: 


The patch file built by GHOST! at system boot time. 


INSWAP USER: 


The current inswap and outswap users' core (if any). This figure has the 
same format as the Incore Users display. 


INCORE USERS: 


The current incore users' core. 


CONTROL SECTION MAP: 


A map of the monitor modules' start addresses. 


SYMBOL MAP: 


The symbol map. 


TABLE OF CONTENTS: 


The Table of Contents for the ANLZ dump. 
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Table 13. irap and Interrupt. Locations for XPSD 
Instructions 



Location 




-— - 

Name of 


of XPSD 


Meaning 


Handler 


X'40' 


. Nonal lowed operation ;trap 


NOPPSD ; 


X'41' 


Unimplemented instruction 
trap 


UNIMP 


X'42' 


Stack overflow trap 


STKOVF 


X'43' 


Fixed-point arithmetic 
overflow 


FIXOV 


X'44' 


Floating-point fault 


FLTFLT 


X'45' 


Decimal arithmetic fault 


DECFLT 


X'46' 


Watchdog timer runout 


CSESERR 


X'47' 


Multiprocessing usage 


IPT47 


X'48' 


CALl instruction 


CALl PSD 


X'49' 


CAL2 instruction 


CAL2PSD 


X'4A' 


CAL3 instruction 


CAL3PSD 


X'4B' 


CAL4 instruction 


CAL4PSD 


X'4C 


Hardware error trap 


CSE$ERR 


X'4D' 


Instruction exception trap 


CSESERR 


X'4E' 


XDELTA entry 


LEE20 


X'4F' 


JIT pointer 


- 


X'50' 


Power on 


PON PSD 


X'51' 


Power off 


POFPSD 


X'54' 


CLOCK3 counter 


- 


x'ss* 


CLOCK4 counter 


- 


X'56' 


Parity error 


PERPSD 


X'58" 


Counter 1 zero 


CLK1PSD 


X'59* 


Counter 2 zero 


CLK2PSD 


X'5A' 


Counter 3 zero 


CLK3PSD 


X'5B' 


Counter 4 zero 


CLK4PSD 


X'5C 


Input/output interrupt 


IOPSD 


X'5D' 


Control panel 


OCPSD 


X'60' 


COC input interrupt 


COC INI 


X'61' 


COC output interrupt 


COCOUT1 





Table 14. User Table Headings 


Heading 


Source 


Meaning 


USER 




Internal user number. 


ST 


UB:US 


User's state. 


BL 


UB:BL 


Link to previous user in 
same state. 


FL 


UB.-FL 


Link to next user in same 
state . 


FLG 


UH:FLG 


User's flags. 


FLG2 


UH:FLG2 


Exit control bits, miscel- 
laneous control flags. 


JIT 


UBJIT 


Physical page address of 
user's J IT. 


SWPI 


UBrSWAPI 


Swap table index. 


HJIT 


UH:JIT 


Track/sector address on 
the swapping RAD of 
user's JIT. 


AJIT 


UH:AJIT 


Track/sector address 
of user's additional 
JIT. 


PCT 


UB:PCT 


User's page count. 


ACP 


UB:ACP 


Number of associated 
command processor. 


APR 


UB.-APR 


Number of associated 
processor's root. 


APO 


UB:APO 


Number of associated 
processor's overlay. 


ASP 


UB:ASP 


Number of associated 
special processor. 


DB 


UB:DB 


Number of associated 
debugger. 


OV 


UB:OV 


Number of associated 
overlay. 


MF 


UB:MF 


Number of I/O events 
outstanding. 
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Table 


15. Additional User Table Headings 


Heading 


Meaning 


USER 


User number. 


M1SC 


Either time left for user to remain asleep 




or resource wait queue forward link. 


UH:DL 


DO-list address. 


CYL 


User's procedure cylinder number if disk 




pack swapper. 


PRI 


User's current priority. 


PRIB 


User's priority base value. 


NECB 


Number of ECBs to be posted for this 




user. 


UH:NL 


Pointer to head of ECBs to be posted. 



Table 16. Resource Wait Queues 



Name 


Description 


R:SYMF 


Users queued for symbiont file space. 


R'rSYMD 


Users queued for symbiont disk granule. 


R:OCR 


Users queued for OPEN/CLOSE. 


R:DPA 


Users queued for swapper granule. 


RrQFAC 


Users queued for ALLOCAT. 


R:NQW 


Users queued for ENQ. 



Table 17. Swap Table Terms 


Location 


Meaning 


S:S1R 


Swap in requests posted. 


S:HIR 


High priority requests posted. 


S:SIP 


Swap-in progress flag. 


#SWAP$DEV 


Interrupt bypass count. 


S:CUN 


Current user number. 


S:ISUN 


In-swap user number. 



Table 17. 


Swap Table Terms (cont.) 


Location 


Meaning 


SrCUIS 


Count of users in system. 


S.-IDLF 


; s Idleffdg'i * 


SB:OSN 


'Number of out-swap use'rs. 


SB:OSUL 


* Out-swap user list. 


S-.BECL 


Beginning and end command list 




for each outswap user. 


SB:NP 


Number of in-swap processors. 


SB:PNL 


In-swap processor numbers. 


SB:FPN 


Number of freed processors. 


SB:FPL 


List of freed processors. 


MrSWAPD 


Address of swap device. 


MB:SDI 


DCT index. 


MB:SFC 


Swap function code. 


MB: # RTRY 


Retry count. 


M:CLBGN 


Beginning of current command 




list. 


MH:CLEND 


End of current command list. 



Table 


18. Partition 


Tables Headings 


Heading 


Source 


Meaning 


# 


Calculated 


Index to partition tables. 


ACCOUNT 


PLDrACT 


Current running account. 


USR 


PLBrUSR 


Number of users in 
partition. 


FLG 


PLHrFLG 


Partition control flags. 


QN 


PLH:QN 


Quantum time of 
partition. 


TOL 


PLH.-TOL 


Total jobs run in this 
partition. 


CUR 


PLH:CUR 


Current Jobs selected in 
this partition. 


TL 


PLH:TL 


Lower time limit. 


TU 


PLH.-TU 


Upper time limit. 


SID 


PLH:SID 


System ID. 
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Table 19. Processor. Table Headings 


Heading* 


Source 


Meaning- ; 


P # ■■■'■■ '...' 


- 


Processor index number.' 


PrNAME 


PrNAME 


Processor name.* * , ' 


HPP 


PB:HPP 


Head of 'processor's, i physical page chain. 


TPP 


... PBrTPP 


Tail of processor's physical page chain. 

' .:'■' % 


PSZ 


PB:PSZ 


Processor's procedure size in pages. 


DSZ 


PB:DSZ 


Processor's initial data size in pages. 


DCBSZ 


PBrDCBSZ 


Size in pages of DCB area. 


PDA 


PH:PDA 


Disk address of procedure. 


DDA 


PH:DDA 


Disk address of data and DCBs. 


UC 


PB:UC 


Use count on processor. 


LNK 


PBrLNK 


First overlay number for this processor. 


PVA 


PBrPVA 


Virtual page address of the processor's procedure. 


HVA 


PBrHVA 


First page available to the processor. 


PC# 


PB:PC # 


Procedure cylinder number. 


DC # 


PB:DC # 


Data cylinder number. 


SA 


P-.TCB 


Starting address and flags. 


TCB 


PrTCB 


TCB address. 



Table 20. ALLOCAT Headings 



Heading 


Meaning 


TOP 


Top index into buffer. 


BOTTOM 


Bottom index into buffer. 


WORDCNT 


Number of disk addresses in buffer. 


TEMPBOT 


Set if ALLOCAT changing buffer. 


BUFLAGS 


Bit = HGP empty, Bit 1 = buffer just filled, Bit 2 = buffer just emptied. 


ADJSTCNT 


Number of entries manipulated by ALLOCAT; may be either positive or negative 


GRANULES AVAIL 

. 1 


Total number of granules/cylinders remaining in system (in hexadecimal notation). 
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Table 21. ]/Q Table Headings 



Table 22. Device Control Table Headings (cont.) 



Heading 


Meaning 


CIT3-5 


Channel Information Tables 3-5 


DEVICE 


yyndd for this device 


ADDR 


Hardware address- 


CX 


Channel index 


OIDTS 


From DCT3 - Set bits indicate: 




O output 




I input 




D down 




T timed out 




S SIO reject 


BPWXKCSB 


From DCT5 - Sets bits indicate: 




B Device busy 




P Clean-up pending 




W Wait until done 




X Data transfer 


> 


K Wait for key-in 




C Control task 




S SIO while manual 




B BIN mode 


QX 


I/O queue index 


AIO 


Last AIO status 


TDV 


Last TDV status 



Table 22. Device Control Table Headings 



Heading 


Meaning 


# 


DCT number. 


DEV 


Active I/O address. 


PRI 


Primary ]/0 address. 


ALT 


Alternate I/O address. 


CIT' 


Channel (CIT) index. 



Heading 


Meaning 


IO FLG 


I/O legality: 




..., t 11 - in and out 




TO = out only 




01 = in only 


DEV TYP 


Type mnemonic. 


DEV FLGS 


State of device. 


IO Q # 


IOQ index. 


CDW ADRS 


Command doubleword address (WA 
resolution). 


PRE HAND 


Handler preprocessor word address. 


POST HAND 


Handler postprocessor word address. 


ACT CNTR 


Device activity counter. 


IOINT 
DEADLINE 


Value to match against I/O 
clock. 


AIO INT STAT 


AIO status word. 


TDV STATUS 


TDV status doubleword. 


CHAN FLNK 


Link to next entry. 


PRE-EMPT 


Real-time pre-empt flag. 


IS 


7446 table. 


HAND CODES 


Handler function flags (first 8 bits 
contain retry function code; the 
second 8 bits contain the fol- 
low on code). 


TIME INCR 


Time-out increments. 


SIO CC 


SIO condition codes. 


TDVCC 


TDV condition codes. 


TIO STATUS 


TIO status. 


DISC FLAG 


Disk flag. 


HGP DISP 


Heading Granule Pool (HGP) 
displacement if disk. 


RMA FLGS 


Partitioning flags. 


SIO COUNTER 


Number of SIOs done to this 
device. 
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Tabie 23. IOQ Table Headings 



Heading 


Meaning 


i ' ' ' ' 


IOQ table number. 


BAK 


Back link to next entry, 


FVVD 


Forward fink to next entry. 


DCT # 


t>CT. index. 


MNE 


TEXT name of device f*om SYSGEN. 


STAT 


Software status. 


FCN 


Original function code (IOQ4). 


CODS 


Current function code (IOQ5). 


DC BAD 


DCB word address (if any). 


BUF 


Buffer word address if bit and 1 reset; 




CDW word address if bit 1 set (swapper); 




CDW word address if bit set (other). 



Table 


; 23. IOQ Table Headings (cont.) 


Heading 


Meaning 


TIM 


Number of timeout increments. 


csw. 


Number of commands used if IOQ8 




bit Oor 1 set. 


JNRA 


Original number of recovery tries. 


NRT 


Remaining number of recovery tries. 


RAD AD 


Disk address. 


E A ADR 


End action word address. 


EA INFO 


One word to return to end action 




receiver. 


PRIO 


Priority of this event. 


USER 


User number of I/O requester. 





Table 24. COC L 


ne Table Headings 


Heading 


Source 


Meaning 


LINE 


Calculated 


Line number. 


USER 


LB.-UN 


Associated internal user. 


TYPE 


COCTERM 


Terminal type. 


EOMTIME 


EOMTIME 


End of message time for a read. 


BUFCNT 


BUFCNT 


Number of buffers in use for line. 


CPOS 


CPOS 


Current carriage position. 


RSZ 


RSZ 


Record size requested by user while read is pending. 


MODE BYTES 


MODE-MODE4 


Terminal mode indicators. 


TL 


TL 


Pointer to tab buffer. 


II 


COCII 


Input insertion pointer for line. 


IR 


COCIR 


Input removal pointer for line. 


ARSZ 


ARSZ 


Accumulated record size while read is pending. 


CPI 


CPI 


Initial carriage position for a read. 


OI 


COCOI 


Output insertion pointer for line. 


OR 


COCOR 


Output removal pointer for line. 


OC 


COCOC 


Count of characters pending output. 
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Table 


25. AVR .Table Headings 


Heading 


Meaning 


SER# 


Serial number of tape or pack. 


PUB 


Set if public. 


POS 


Set if positioned. 


AVR 


Set if AVRed. 


SCR 


Set if scratch tape. 


HLD 


Set if held. 


PTL 


Set if positioned to label. 


UPL 


Set if user positioned label. 


OPN 


Set if open. 


NOU 


Number of users. 


TPOS 


Tape mark count. 


USER 


User number. 


SOLICIT 


Index to special AVR tables. 


INI 


Set if volume initialized. 


VER 


Set if volume verified. 


MTD 


Set if mounted. 


PRIM 


Set if primary volume of private 
set of volumes. 


HGPDISP 


Displacement from HGP. 



Table 26. Symbiont Table Headings 


Heading 


Meaning 


# 


Index number of table. 


SQUE 


Symbiont queue chain. 


SNDDX 


DCT index of symbiont device. 


TYPE 


TEXT name of symbiont device 
from SYSGEN. 



Table 26. 


Symbiont Table Headings (cont.) 


Heading 


Meaning ? 


SSTAT 


Symbiont Status: 




= input symbiont 




T = output symbiont 


SSIG 


SymBiont signal character (e.g., 




L, Q, etc.). 


SRET 


Symbiont return when activated 




from chain. 


SCNTXT 


Context block doubleword address 




displacement. 


SYMX 


Symbiont index: 




1 = input 




2 = output 


TYP 


Device type. 


LNK 


Remote chain. 


FLAG 


Remote flags. 


SUSP 


Suspend bit for IRBT. 


QUE 


IOQ index for IRBT. 


SQHD 


Symbiont queue chain head. 


SQTL 


Symbiont queue chain tail. 



Table 27. TSTACK Headings 



Heading 


Meaning 


ADDRS 


Virtual address of displayed contents. 


STACK OFFSET 


Index into stack. 


CONTENTS 


Contents of stack. 


RELATIVE LOC 


Address that stack contents point to, 
in symbol plus displacement form. 
If the stack cell contains a relative 
location, the instruction at that lo- 
cation will be displayed if it is an 
address modifying instruction (e.g., 
B, BAL, LPSD). 


INSTRUCTION 


Symbolic instruction at the address 
contained in the stack position. 
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ANLZ MESSAGES • 

Table 28 contains *he messages thai - are output by ANLZ. 
Most of these messages Identify error conditions. Others 
merely supply information. 



mi COMM/tim SUMMARY 

Table 29 summarizes ANLZ commands. The left-hand 
column contains the command format, the right-hand column 
contains the command description. 



Table 28. ANLZ Messages 



Message 


. Description 


ANLZ HERE 


The ANLZ program has begun operation. 


ANLZ: ENTER COMMAND, N/L SAYS TO DO ALL 


This message issued to operator after GJOB ANLZ key-in. 
Operator may respond with one of the following: 

NO = just exit 

TA = read recovery-built tape 

HE = run interactively from console 

CP = read CP5DMP file 

0-7 = read indicated MONDMP file 

N/L = do default ghost run 


ANLZ GHOST FINISHED 


The ANLZ ghost has completed processing the core 
image file. 


ANLZ USING MONDMPn 


ANLZ has been commanded to read a MONDMP file. 
The value specified for n indicates the number of the 
MONDMP file. 


BAD COMMAND 


The command was unrecognizable. 


CANNOT OPEN FILE name 


The file specified by the INPUT command cannot be opened. 


CAN'T GET THE BUFFER 


The user was not allowed enough core in his account to 
read in the monitor symbol stack. 


COUNT ERROR 
TAIL ERROR 


The tail and last page in a chain do not agree. 


ENTER TAPE TYPE: 7T, 9T, BT, ETC. . . 


The user must supply the tape type if tape input is to be used. 


ERR/ABN CODE = xxxx**dcb 


An ]/0 error or abnormal condition occurred during an 
INPUT operation. 

xxxx is the error or abnormal code. 

deb is the address of the DCB associated with it. 


LOCI > LOC2 


The first location entered for a loc], I0C2 (or similar) com- 
mand was greater than the second location. 


xx PRIVILEGE LEVEL NOT HIGH ENOUGH 


The user privilege level was not high enough for the 
requested operation. 


SORRY, NO PAGE xx 


The page containing the location specified by the user 
was not found in the input file. 


THE LAST PHYSICAL PAGE IN THE FILE IS xx 


The size of the file read from tape by the INPUT com- 
mand is specified by the last physical page in the file. 
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Tdble 29.' ANLZ Command Summary 



1 ,__ i , _-, 

Command 


Description ! 


t 


— . ; , ' i 

Dumps the last location and is used in connection with loc 
and loc|, loc2- 


* 


• *' . ■ 
Dumps the indirect location and is used in conjunction with 
loc and locj, loc2« 


AL[L] 


Performs the functions of the INPUT, DISPLAY, and RUN 
commands and of ANLZ (except dumps) when initiated 
by the automatic recovery procedure. A numerically and 
alphanumericatly sorted monitor map is output at the end of 
the ALL display. 


BF fid 


Specifies the name of the boot file that represents the monitor 
being examined by ANLZ. The file M:MON in :SYS is as- 
sumed by default. 


CL[OSE] 


Causes input dump file to be closed. 


COpvtPARE^Ioc],^ 


Compares the dump (locations loc] through loc2) with the 
running monitor and outputs the locations with nonequal 
contents. 


: DE[LTA] 

i 


Associates the debugger Delta with ANLZ. 


DI[SPLAY] option 


Outputs information existing at the time of the crash. The 
options are 




Aj[lTSJ —JIT, AJIT, and context area of all incore users. 




AT[ABLES] -incore portion of ALLYCAT's tables. 




AV[R] -tape and disk tables. 




CI[TSj[, index] . . . —all or requested entries of Channel 
Information Tables. 




CO[C][, index]. . . —all or requested entries of COC tables. 




CU[N] —current user's JIT, AJIT, and context area. 




\ DC[T][,?ndex]. . .j— all or requested entries of Device 
' Control Tables. 




EL[OG] —incore error log buffers. 




FQ-Free I/O Queueing tables. 




IO[, chan] . . . —devices on requested I/O channels. 




IQ[, index]. . . —all or requested entries of I/O queueing 
tables. 




JIT[, id][, loci, I oc2]— contents of the JIT for the user 

specified by id or for the monitor. 




MR[, loci, loc 2]— monitor's root. 




Oj[lT] -all of the out of core JITs. 
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Table 29. ANLZ 


Command Summary (cont. ) 


Command 


Description 


DIJSPLAY] option (cont.) 


OS — user outswap tables. 




PA[RTITIONS][, index]. . . -all or requested entries of 

partition tables. 




PF[ILE] —patch file that was created last. 




PM-page matrix identifying the owners of all pages. 




PN-processor inswap tables. 




PP,pageno[, loci, loc2] —contents of the indicated 
physical page. 




RA[T] —resource allocation tables. 




RE [GISTERS J —software check code, software check mess- 
age, and the first two register blocks. 




RB[T] —remote batch tables. 




RC[XT] —area of memory occupied by the recovery routines. 




RQ —resource subqueue lists. 




ST[ABLE] —output symbiont tables. 




SW[APPER]— contents of the swap/swap scheduling tables. 




SY[MBlONT]-RBBAT recovery file. 




TP —transaction processing tables. 




TR[APS] —contents of trap and interrupt locations. 


■■ ' 


TS[TACKj[, id] —temp stack of the user specified by id or 
of the monitor. 




US(ER][, id] . . . —user tables of the specified users. 




VP, pageno[, loci, loc2]— contents of the specified virtual 




page. 




WHY —software check code and software check message. 


DU[MP] lo Cl/ loc 2 


Dumps specified range of addresses. 


en[d] 


Exits from ANLZ. 


he[lp] 


Lists all ANLZ commands. 


I N[PUT] option 


Directs ANLZ to input from a particular disk or tape file or 
to open a file. The options are 




LA[ST] — opens the last file formed by the recovery 
procedure. 
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Table 29. ANLZ Command Summary (cont.) 



Command 


Description 


1N[PUT] option (cont.) 


number —opens (he numbered crash file formed by the 
recovery procedure.. 

TA[PE] — reads a labeled tape created by the recovery 
procedure. 

' . \ CP[5DUMP] -opens the CP5DUMP file. 


IS 


Reads fbe sorted symbol table from a previous ANLZ run. 


Line Feed (or carriage return) 


Dumps the contents of the next location and is used in con- 
junction with loc and loci, I0C2. 


loc 


Outputs the contents of the specified location. 


loc.,loc« 


Outputs the contents of memory locations between loc. 
and loco. 


loc = value 


Places the value in the specified location of the running 
-monitor. 


LP[rows] 


Directs the output of ANLZ to the line printer, where rows 
is dump width in hexadecimal words. Default is full line. 


MA[P], id 


Loads the map of the specified user if his JIT is in core. 


mo[nitor] [di[splay]] 


Turns the monitor display mode on and off. 
MONITOR turns the display mode off. 
MONITOR DISPLAY turns the display mode on. 


no[delta] 


Disassociates the debugger Delta from ANLZ. 


pr[int] 


Closes the output symbiont file to allow output to the line 
printer without requiring a return to TEL. 


RO[\VS], value 


Establishes width of dump output in number of words, where 
value may be 1 through 12. 


RU[N] option 


Outputs various linked lists < 
the list and displaying each 

MO[N.TOR][,{5 gno }] 

processor] [,{;| a J 

RT — real-time page chc 

ST E AT 4'{ q #j| ~ sfate 
L w JJ num i 

defa 


Df the monitor by running through 
entry. The options are 

— monitor pages. S, the default, 
indicates all. A specific page 
may be requested. 

— processor pages. S, the de- 
fault, indicates all. A par- 
ticular processor may be 
specified. 

lins. 

1 queues. A particular queue 
aer may be specified, or S, the 
ult, indicates all. 
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Table 29. ANLZ Command "Su 


mmary 


(con'.} . . 


Command 


Description , 


RU[N] option (cont.) 


US[ER] , j . ,| —user pages for a particular user (id), or 
L .for all users (S). S is the default. 

XD[ELTA] - XDELTA's page chains. 


SE[ARCH] / value,loc 1/ loc. 


, ■ Searches for and Qutputs all words between loc. and loc_ that 
contain the value under the mask. 


SM[ASK], value 


Sets the mask to the specified value. 


symbol/ 


Displays the contents of the monitor location specified by 
symbol. 


SY[MBOLS][fid] 


Creates a numerically sorted monitor map, using the fid spec- 
ified or MONSTK. :SYS. 


UC[rows] 


Directs the output of ANLZ to the on-line terminal, where 
rows is dump width in hexadecimal words. Default is full line. 


un[map] 


Turns off the mapping mode of operation. 
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5. ERROR MESSAGE FILE 



IHTRODUCTION 

The error messages for the CP-V monitor and several CP-V 
processors are contained in an error message file, called 
ERRMSG. This file is initially created either through 
punched card or on-line terminal input and is maintained 
through use of the Edit processor. This chapter describes 
the structure of the ERRMSG file and the techniques 
required to create and modify the file. 

Codes for detected error conditions are recorded in the [ob 
information table (JIT). The error code is placed in J: ABC 
(high-order byte) and the subcode is placed in ERO (right- 
justified). When CCI (batch jobs) or TEL (on-line jobs) is 
entered, a message is printed to correspond to the code and 
subcode. This message is obtained from the error message 
file (ERRMSG) via a keyed read using a key constructed 
from the group code, error code, and subcode. If either 
the file or the record corresponding to the code is missing, 
the error code itself will be printed. Otherwise, the mes- 
sage and the error code will be printed. 



FORMAT OF ERROR MESSAGE FILE 

Each record in the error message file' contains the EBCDIC 
text of one error message. The key of each record is one 
word long and has the form 



03 



GC 



EC 



SC 



i 2 3 I 4 5 6 7 1 8 9 10 111 12 13 14 15116 17 18 I9I2O 21 22 23U4 25 26 27! 28 29 30 31 

The first byte always contains 03, which is the count of 
bytes in the key. The second byte is the group code, the 
third is the error code, and the fourth is the error subcode. 

Group codes presently assigned are 






Monitor 


5 


CCI 


1 


PCL 


6 


DRSP 


2 


Loader 


7 


Batch 


3 


TEL 


8 


Analyze 


4 


Runner 







Messages in the file with group codes other than zero are 
not handled by the monitor itself. Error codes currently 
assigned within the monitor group are 

— 7F I/O error and abnormal codes 

80 - 9F COBOL error codes 

A0 — BF Other Monitor codes 

CO - FF Unused 



The meaning of the assigned codes are defined in CP-V/TS 
Reference Manual, 90 09 07, CP-V/BP Reference Manual, 
90 U 64, and in the ANS COBQL/LN Reference Manual, 
90 15 00. 



CREATING ERROR MESSAGE FILE 

The ERRMSG file is initially entered into the system either 
through a card reader or an on -I ine term! na I at the centra I si te . 
The procedures for each type of input are described below. 



Warning: If an installation modifies the text of TEL error 
messages, ?t should be noted that TEL stores dy- 
namic information in the error message buffer and 
some of the text may be clobbered. 



CARD READER INPUT 

Card input of the error message file is handled by the Error 
Message File Writer (ERRMWR). This program reads cards, 
interprets the first six columns as a hexadecimal number, 
converts this number into a three-byte key, and writes the 
card image exclusive of trailing blanks as a keyed record 
in the ERRMSG file in the account under which ERRMWR is 
executed. This account should be :SYS for the system error 
message file. 

The card format is 

/] 2 3 456789 1011 12 13 14 15 16 17 18 192021 22 



Hex. code 



GC 



EC 



SC 



Text of Message 



Example: 

Assume that the message ILLEGAL OPCODE is to be placed 
in the error message file for the monitor error code AE. The 
group code and subcode in this case are both zero. Thus, 
the card for this message would be punched as follows: 

1 23456 78 9 10 11 12 13 14 15 16 17 18 19 20 



Hex. code 



00 



AE 



00 



Text of Message 



ILLEGAL OPCODE 



Keys generated by the ERRMWR program have the form 



03 



12 3 14 5 6 7 



GC 
(col. 1-2) 



EC 

(col. 3-4) 



8 9 10 llll2 13 14 15116 17 18 19 1 20 21 22 23 



SC 

(col. 5-6) 



24 25 26 27128 29 30 31 
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During conversion of the key, leading Blanks are treated as 
zeros. NonhexadeciroaJ letters result in output of a warn- 
ihg message and cause the card to be ignored. The card 
image is scanned from right to left to determine the rightmost 
nonblank character, and the count of characters is adjusted 
so that trailing blanks are not y/riften. A new line character 
X'15* is appended to the message. . * " ' ' 



The message may be continued in column 1 of the follow- 
ing card by appending a continuation character 0) ar the 
end of the message in the first card. Only two cards per 
message are allowed. 



A card containing an asterisk in column 1 is a control card 
and is used to set the format of the record written in the 
file. If column 2 of the control card contains a 0, the 
message key is appended to the front of the message text 
and is included in the record. If column 2 of the control 
card contains a 1, the key is not included in the record 
text (this is the default condition). Control cards can be 
placed anywhere within the data deck except between 
continuation cards. 



TERMINAL INPUT 

Creating or modifying the error message file can be ac- 
complished from the termiftal by using Edit or ERRMWR. 

Example* 1: Using Edit . .' * "' 

JBUILD^MSG®> ( \ 

IjCOQ 00AB00 THAT'S^NO DEBUGGER! © 
2>0Q0 '00A601 THAT'S NO OP CODE © 
--• 3.000 © 

J[SETM:EI DC/MS G © 

JERRMWR® . ' ■ '■ 

Example 2: Using ERRMWR 

JSET M:EI UC © 

J_ERRMWR© 

>00AC01 DON ! T ISSUE CAL3 OR CAL4© 

>© 

! 



64 Creating Error Message File 



6. SYSTEM ERROR LOG fill 



INTROOUSTttH 

All hardware malfunctions and sqme softy/are problems 
occurring during system operation,, whether recovered or 
not, are recorded in a special, disk storage file. '.-This file 
is periodically copied into a standard file (ERRFft«:_) by a 
ghost program (ERR:FIL) which is initiated automatically 
for that purpose. 

ERRFILE may be -listed and summarized by the Error Log 
Listing processor that is described in this chapter. ERRFILE 
is also available for on-line preventive maintenance of 
the system and for diagnosis and prediction of hardware 
malfunctions. 



ERR:F!L.PROGRAM 

ERRrFIL copies the special file created by ERRLOG onto a 
normal keyed file (ERRFILE) in the :SYS account that is more 
readily available to diagnostic programs. 

ERR:FIL is a ghost job that is awakened by ERRLOG when- 
ever five errors have been recorded. ERR:FIL may also be 
awakened by a program with diagnostic privilege by using 
the initiate job CAL(CAL1,6 FPT)or by an operator key-in 
of GJOB ERR:FIL. 



ERROR LOG LISTING PROCESSOR 

The Error Log Listing processor (ELLA) provides an efficient 
too! for listing and sorting the error log file, ERRFILE, which 
is automatically generated and updated by the CP-V system. 
(ERRFILE is described in Appendix E. ) ELLA output furnishes 
a meaningful and comprehensive diagnostic evaluation of 
the system and its peripherals, aiding in the early detection 
of product failures and thus increasing the reliability, main- 
tainability, and availability of the system. 

The set of ELLA commands allows the user to first specify 
the kinds of errors in which he is interested, and then re- 
quest a listing of those kinds. Four types of listings are 
available: 

• A chronological listing of error log entries. 

• A sorted listing of error log entries. 

• A summary of error log entries by category. 

• A summary of error log entries in graphic form. 



Towards the end of this chapter, there is a section which 
contains a set of predefined tasks that should be useful to 
the person who needs periodic error log reports but has no 
need for a more precise understanding of the ELLA processor's 
command structure. (See "Predefined Tasks".) 



STARTING EXECUTION 

ELLA may be run as an on-line, batch, or ghost job. Norma! 
operating procedures are observed in each of these modes. 
Batch and on-line operations are illustrated in Examples 1 
and 2. These first two examples are intended only for ELLA 
users who are hot familiar with CP-V. 

The use of ELLA is restricted to authorized system users whose 
accounts have a diagnostic privilege level (AO or higher). 
If the user has insufficient privilege, ELLA will abort with 
the message 



INSUFFICIENT PRIVILEGE LEVEL ABORT 



Note: Initiating ELLA as a ghost job enables the operator 
to issue ELLA commands from the operator's console. 
However, judgement should be exercised when ini- 
tiating ELLA in this fashion since ELLA commands 
will be intermixed with normal operator console 
material. 

INPUT/OUTPUT ASSIGNMENTS 

ELLA input and output is divided into three separate 
functions: 

• Error log input. 

• User command input. 
e Listing output. 

Error log input is always taken from the system error log file, 
ERRFILE. Without user intervention, the remaining two 
functions assume default assignments depending on the mode 
in which ELLA is run. The default assignments are listed in 
Tables 30, 31, and 32. (They are based upon the assumption 
that the SI and LO operational labels weregiven the standard 
assignments during SYSGEN. ) The assignment of the output 
listing function may be altered by the user during ELLA ex- 
ecution through use of the ELLA SET command. The tables 
specify the ELLA SET command formats that are required to 
make the reassignments. The SET command is described in 
detail below. 

I SET The SET command reassigns the listing and message 

output device assignment during execution of ELLA. (It 
changes the device assignment in the M:LO DCB. ) The for- 
mat of the command is 



,LIST. {£} 



wh< 



SET 



LP specifies line printer. 

KP specifies operator's console for the ghost and 
batch modes and on-line terminal for the on-line 
mode. 
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Example 1. Botch Operation of ELLA 



f Tfin 

| ELLA commands 



WW5"S< 



K 




X 



1ELLA 



i JOB FEOPER, SITE 102, E 



"""X 



f 



For batch operation of ELLA, control commands and ELLA commands are punched on cards and the cards are submitted 
to the site operator. 

In this example, the account number (FEOPER) and account name (SITE 102) were chosen because they had been re- 
served for diagnostic activity at that particular site. In order to run ELLA in the batch mode, the account was 
authorized a privilege level of A0. (The privilege level is not specified on the JOB card because it is automatically 
associated with the account.) The execution priority E was specified to given the job a high execution priority. (The 
privilege level determines the types of things that a |ab is allowed to do; the execution priority is a determining fac- 
tor in how quickly a |ob will be selected for execution. ) 



Example 2. On- Line Operation of ELLA 



XEROX CP-V AT YOUR SERVICE 

ON AT 13:48 JUL 08, '74 

LOGON PLEASE: FEOPER, SITE1 02 ,RSD © 

JELLA© 

13:49 JUL 08, '74 

ELLA 7080D6-A00 



*END© 
1PRINT © 

JOFF© 

In this example, the user logged onto the system after receiving the CP-V salutation and log-on request. The account 
number and name used are the same as in the previous example. (The account was authorized for both batch and on- 
line operations. ) The account has a password associated with it which is to be used for security reasons during on-line 
operation; i.e., if the password is kept confidential, it prevents unauthorized on-line use of this special diagnostic 
account. The password is entered following the name and account. Here, the password RSD was entered. 



66 Error Log Listing Processor 



After the log-on, CP-V prompted, for input with an exclamation point. The user entered 

ELLA© 

to request the Error Log Listing program and ELLA responded with its salutation and prompted for input with an asterisk. 
The user then entered ELLA commands, finishing with the END command which returned control to the system. The 
system then prompted with an exclamation point. (Actually, control was returned to a system command, processor 
called TEL which is described in detail in the CP-V/TS Reference Manual, 90 09 07.) 

ELLA can output its listing on the user's terminal or on the line printer. If printer output is selected, the system holds 
the output on a disk file until either the PRINT or OFF command is entered. In the example, the user executed the 
PRINT command which caused the system to produce the printer output. The user then proceeded to perform other 
tasks, eventually ending the on-line session with the OFF command which logged the user off the system. 



INPUT/OUTPUT CHARACTERISTICS 

Whenever ELLA listing output is assigned to the line printer, 
the output contains two additional types of information: 
user commands received and diagnostic messages. ELLA 
user commands are listed on the printer to present a com- 
plete record of the user listing session. They are preceded 



by one asterisk. Diagnostic messages (due to abnormal con- 
ditions or operational errors) are preceded by two asterisks. 

Whenever the command input function is assigned to the 
operator's console (ghost initiation of ELLA) or the user's 
terminal (on-line initiation), diagnostic messages are 
printed on that input device (preceded by two asterisks) as 
well as on the line printer. 



Table 30. ELLA On-Line I/O Functions 



Function 


Associated 

DCB | 


Default 
Assignment 


Possible 
Assignments 


ELLA SET 

Reassignment 

Command 


Comments 


Source 
error log 


M:BI 


ERRFILE 


ERRFILE 


(none) 


Data base from which ELLA reads source, records 
for printing. 


Command 
input 


M:SI 


User's 
terminal 


User's 
terminal 


(none) 


Device from which ELLA reads commands (and 
to which it prints diagnostic messages). 


List 
output 


M:LO 


User's 
terminal 


User's 
terminal 


SET, LIST, KP 


Device to which ELLA lists error log data. 


Line 
printer 


SET, LIST, LP 


Device to which ELLA lists error log data, com- 
mands received, and diagnostic messages. 



Table 31. ELLA Batch I/O Functions 



Function 


| Associated 
! DCB 


Default 
Assignment 


Possible 
Assignments 


ELLA SET 

Reassignment 

Command 


Comments 


Source 
error log 


M:BI 


ERRFILE 


ERRFILE 


(none) 


Data base from which ELLA reads source records 
for printing. 


Command 
input 


M:SI 


Card 
reader 


Card 
reader 


(none) 


Device from which ELLA reads commands. 


List 
output 


M:LO 


Line 
printer 


Line 
printer 


SET, LIST, LP 


Device to which ELLA lists error log data, com- 
mands received, and diagnostic messages. 


Operator's 
console 


SET, LIST, KP 


Device to which ELLA lists error log data and 
diagnostic messages. (Using the operator's con- 
sole for lengthy output is not recommended. ) 
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Table 32. ELLA Ghost I/O Functions 



Function 


Associated 
DCB 


Default 
Assignment 


Possible 
Assignments 


ELLA SET 

Reassignment 

Commands 


Comments 


Source 
error log 


M:BI 


ERRFILE 


ERRFILE 


(none) 


Data base from which ELLA reads source records 
for printing. 


Command 
input 


M:SI 


Operator's 
console 


Operator's 
console 


(none) 


Device from which ELLA reads commands (and 
to which it prints diagnostic messages. ) 


List 
output 


M:LO 


Line 
printer 


Line 
printer 


SET, LIST, LP 


Device to whicn ELLA lists error log data, com- 
mands received, and diagnostic messages. 


Operator's 
console 


SET, LIST, KP 


Device to which ELLA lists error log data and 
diagnostic messages. (Using the operator's con- 
sole for lengthy output is not recommended.) 



IHTERRUPTIKG ELLA EXECUTION 

On-line ELLA execution may be interrupted at any time by 
use of the BREAK key on the user's terminal. This causes 
ELLA to terminate its current activity and to prompt for a 
new command. 

When ELLA is initiated as a ghost job or a batch job, ex- 
ecution may be interrupted through use of the operator INT 
key-in. The effect upon a ghost job is similar to that of the 
BREAK function on-line. The effect upon a batch job is to 
cause the next command to be read from the card reader. 



SLIS produces a sorted listing of qualified error log 

entries. 

SUM produces a categorized summary of qualified 

error log entries. 

DISP produces a summary of qualified error log en- 
tries in graphic form. 

END terminates ELLA. 



ELLA COMMANDS 

ELLA accepts three types of commands: boundary commands, 
task commands, and the device assignment command (SET, 
described previously). Boundary commands establish or 
change the limits that are to be applied to all subsequent 
task commands; i.e., boundary commands allow the user to 
specify the types of errors in which he is interested. Task 
commands initiate the execution of a particular type of list- 
ing. The device assignment command is used to change the 
listing and message output device during execution of ELLA. 



Note that error log entries are displayed only if they qualify. 
To qualify for inclusion in a display, an error log entry 
must pass a\\ boundary tests in force at the time the display 
is generated. If no boundary commands have been entered, 
all error log entries qualify. Those error log entries which 
fail to pass one or more of the boundary tests are ignored. 
(Boundary commands are described following the task 
commands.) 



CLIS The CLIS command requests a chronological list- 

ing of the error entries in the order in which they appear in 
the error file. 



TASK COMMANDS 

Task commands are used to request the ELLA displays and to 
terminate ELLA. ELLA task commands are: 

CLIS produces a chronological listing of qualified 

error log entries. 



The format of the CLIS command is 



C[LIS] 



An example of a CLIS listing is given in Example 3. Table 33 
lists the error log entry headings printed by ELLA and notes 
the manner in which all values are printed. 
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Example 3. Use of the CLIS Command 



In this example, the user chose to initiate ELLA on-line. The user did not desire a lengthy listing at his terminal. 
Therefore he reassigned the listing function to the line -'printer using the SET command. 

JELLA© 
*SET,LIST,LP© 
*CLIS © 
*END© 
JPRINT© 

After the CLIS command was issued, ELLA produced the chronological listing and then prompted for another command. 
The user desired no further listings, so he terminated ELLA with the END command. He then issued the system PRINT 
command which caused the listing to be output to the printer. The output that was sent to the line printer is shown 
below: 



♦CLIS 



CHRONOLOGICAL LISTING 



FROM 00/00/00 00:00:00:000 
TO 12/31/99 23:59:59:999 



*** SYSTEM IDENTIFICATION *** 

CORE 
TIME (K) SITE I.D. SYSTEM 

11:36:00:000 00128 PRT101 CP-V COO 



*** CONFIGURATION *** 



-OPTIONS TIME 

CPU SYMB RT RB ONLN TP MP RES 

S67 Y Y Y Y Y Y 02 







I/O 


ADRS 


DCT 


TIME 


MDL 


PRIM 


ALTN 


INDEX 


11:36:00:000 


7012 


0001 


0001 


01 




7140 


0003 


0003 


02 




7160 


0001 


0004 


03 




7115 


0002 


0002 


04 




7212 


01F0 


01F0 


05 


11:36:00:000 


7322 


0080 


0080 


06 




7322 


0081 


0081 


07 




7271 


00E0 


00E0 


08 




7271 


00E1 


00E1 


09 




7271 


00E2 


0OE2 


0A 


11:36:00:000 


7271 


00E3 


00E3 


0B 




7611 


0010 


0010 


OC 



*** TIME STAMP *** DATE=07/10/74 TIME=1 2:00 :00:004 



*** SIO FAILURE *** 



TIME MDL 

12:36:30:782 7323 

12:37:29:518 7323 

12:40:10:398 7323 



I/O 


SIO- 


TDV- 


SUBC 


TDV CUR 


REM 




ADRS 


STAT CC 


STAT CC 


STAT 


COMM DA 


BYTES 


MF 


0083 


2000 6 


1000 6 


00 


0011B7 


0001 


00 


0083 


2000 6 


1000 6 


00 


0011B7 


0001 


00 


0083 


2000 6 


1000 6 


00 


0011B7 


0001 


00 
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*** TIME STAMP *** DATE=07/10/74 TIME=1 3 : 00 : 00 : 003 
*** TIME STAMP *** DATE=Q7/10/74 TIME=1 4 : 00 : 00 :003 

***SYMBI0NT INCONSISTENCY*** 

v DCT PEL. SYMB. 
TIME INDEX SECT. DCT 

14:03:13:648 09 • 0110 02 

*** TIME STAMP *** DATE=07/10/74 TIME=1 5:00 :00 :00 4 
*** TIME STAMP *** DATE-- 7/ 10/7 H TIME=1 6 : 00 : 00 :006 

Note that the CLIS command is listed in the line printer listing and that the existing time boundaries, are printed after 
the title. If other boundaries were in force, they too would have appeared. Certain values, such as core size and 
recovery count, are printed in decimal for convenience. Other fields, such as the OPTIONS field, contain flags. 
The true condition is represented by the letter Y, the false condition by the letter N. In this example, the system 
has symbiont capability but does not have remote processing and real-time facilities. 



Table 33. Error Log Entry Headings 



Heading 


Description 


ACCOUNT 
eeeeeeee 


The account (eeeeeeee) in which the faulty file resides. 


— -AIO- 
STAT CC 

XXXX X 


A hexadecimal number (xxxx) representing the AIO device and 
operational status bytes (STAT) and a hexadecimal value (x) 
representing the condition code (CC) returned as the result of the 
AIO instruction. 


CL 

XX 


A hexadecimal value (xx) representing the cluster portion of the 
unit address. 


CONTRLR 
f 


A flag (f) indicating whether or not the controller is partitioned in 
addition to the device. Y means the controller is partitioned; N 
means it is not partitioned. 


CORE 

(K) 

dddd 


Core size in decimal thousands (dddd). 


COUNT 
dddd 


The number of entries (in decimal) that duplicate the previous entry. 


CPU 
ddd 


CPU type (ddd). 


CPU 
ADRS 

XXXX 


CPU hardware address. 


CUR COMM DW-- 

12 

XXXXXXXX XXXXXXXX 


Two hexadecimal numbers (xxxxxxxx) representing the command 
doubleword currently being processed for a device. 


DATE 
mm/dd/yy 


The month (mm), day (dd), and year (yy) that the error log entry 
occurred. 


DCT 
INDEX 

XX 


A hexadecimal value (xx) indicating the order in which the device is 
configured into the system at SYSGEN. The index value for the first 
device is 1. J 
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Table 33. Error Log Entry Headings (conr.) 



Heading 


Description 


ENTRIES 

LOST 

dddd 


A decimal value (dddd) representing the number of error log records 
lost when logging became temporarily, impossible for any reason. 


ENTRY 
COUNT 
dddd 


A decimal value (dddd) representing the number of entries in the 
enqueue table belonging to the specified user at the time the error 
log entry was made. 


ERROR 
CODE 

XXXX 


A hexadecimal value (xxxx) giving the error type code for the failure. 
See Appendix B, "Monitor Error Messages" in the CP-V/BP Reference 
Manual, 90 17 64, for error code definitions. 


ERRLOG— 
CALL ADRS 
xxxxxxxx 


A hexadecimal value (xxxxxxxx) representing the caller's address to 
which the error logging routine will return when logging is completed. 
This is used in isolating software faults. 


FILE NAME 


The name of the file in which a fault has been detected. 


— HIO- 
STAT CC 

XXXX X 


A hexadecimal value (xxxx) representing the status (STAT) and a 
hexadecimal value (x) representing the condition codes (CC) re- 
turned in response to an HIO instruction. 


— INDEX- - 
BAD ENTRY 

XXXXXXXX 


The hexadecimal offset (xxxxxxxx) into a 64-word block in ERRFILE 
that locates the first word of the incorrect entry. 


I/O 
ADRS 

XXXX 


A hexadecimal value (xxxx) representing the physical I/O address. 


I/O 
COUNT 
dddddddddd 


A decimal value (dddddddddd) representing the number of SIG 
instructions executed for a device. This value is reset at system boot 
time and is not reset at recovery (i.e., it is reset for system start-up 
types 1, 2, and 3; see START TYPE in this table). 


I/O ADRS 
PRIM ALTN 

XXXX XXXX 


A hexadecimal value (xxxx) representing the primary I/O address 
(PRIM) by which a device can be referenced, and another hexa- 
decimal value (xxxx) representing the alternate address (ALTN) for 
dual access devices. 


--I/0-- 
STAT CC 

XXXX X 


A hexadecimal value (xxxx) representing the status (STAT) and a 
hexadecimal value (x) representing the condition codes (CC) re- 
turned in response to an I/O instruction. 


LOCATIONS 

xxxxxxxx 

xxxxxxxx 


One to fourteen hexadecimal values indicating the addresses of the 
first fourteen (or less) memory locations exhibiting parity errors. 


--MEMORY STATUS— 

1 2 
xxxxxxxx xxxxxxxx 


Two hexadecimal values (xxxxxxxx) representing the status returned 
In response to an LMS instruction. 


— -MEMORY STATUS WORDS 

12 3 
xxxxxxxx xxxxxxxx xxxxxxxx 


Three hexadecimal values (xxxxxxxx) representing status returned in 
response to an LMS instruction. 


MDL 

dddd " 


A decimal number (dddd) that uniquely identifies peripheral devices 
by the Xerox model number (defined at SYSGEN). 
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Table 33. Error Log Entry Headings (cont . ) 



Heading - , 


Description 


MFI'; . 
XX 


A hexadecimal value (xj') representing the current state of the 
memory fault indicators returned by the hardware in response to an 
RD instruction. AM ^jgrriory fauff indicators will be reset. (Sigma 6 
and 7 only. ) /* ■■ . :.' ' :.*. 


MODE 
d 


A. decimal value (djfencodfng the mode in which the file was opened 
■ where* 1 '- JN;- 2 - DUT; 4 - IN OUT; 8 - OUTIN. 


- -OPTIONS -- 

SYMB RT RB ONLN TP MP 
f f f f f f 


Indicates whether or not the following facilities are available in the 
system: symbiont routines (SYMB), real-time processing (RT), remote 
processing (RB), on-line facilities (ONLN), multiprocessing facilities 
(MP), and transaction processing functions (TP). The flag (f) is equal to 
Y (present) or N (absent). 


ORG 
d 


A single decimal digit that indicates the file organization where: 
I - consecutive; 2 - keyed; 3 - random. 


PAR 
ERRS 

XXXX 


A hexadecimal value (xxxx) representing the number of memory 
locations exhibiting parity errors after a memory scan. 


--POLL- 
STAT CC 

XXXX X 


A hexadecimal value (xxxx) representing the processor fault status 
(STAT) and a hexadecimal value (x) representing the condition 
codes (CC) returned by the hardware in response to a POLP or 
POLR instruction. 


POLR 
RESULTS 

XXXX 


A hexadecimal value (xxxx) representing the processor fault status 
as returned by the hardware in response to a POLR instruction.' 


PSDW — 

12 

XXXXXXXX XXXXXXXX 


Two hexadecimal numbers (xxxxxxxx) representing the contents of 
the program status doubleword. 


RB: FLAGS 

XXXXXXXX 


A word containing bits which define the current state of processing for 
the failing remote station. The meanings of the bits are defined in 
Table 32-1 


REAL 
' ADRS 

XXXXXXXX 


A hexadecimal value (xxxxxxxx) representing the actual memory 
address. In an unmapped system, this is the same as the IA field 
of the PSD. 


RECOV 
COUNT 
dd 


A decimal value (dd) which is set to zero at system initialization and 
incremented by one for every system recovery. 


REL. 
SECT. 

XXXX 


A hexadecimal value (xxxx) representing the relative sector at which 
the inconsistency was detected 


RELATIVE - 
SECT .ADRS 

XXXX 


A hexadecimal value (xxxx) representing the relative sector number 
at which the inconsistency was detected. A relative sector is 256 
words long with each sector on a given device being numbered from 
zero through device end. CP-V maintains file pointers by relative 
sector number to expedite addressing different devices. 
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Table 33, Error Log Entry Headings (conr. ) 



Heading 


Description 1 


REM 
BYTES 

XXXX 


A hexadecimal value (xxxx) representing the remaining byte"' count- 
as returned in response to a TDV instruction. . " 


-RETRY - 

REQ REM 

dd dd 


A two digit decimal number (dd) J representing the maximum number of 
retries (RE Q) after which a device error is returned to requester (value 
obtained froifc .requester's PGB), and another two-digit value (dd) 
Representing retry "request minus the number of entries attempted (REM). 
The range is between retry request and 0. A value indicates the 
operation was terminated due to retry count rundown. 


RPl RP2 RP3 RP4 

XX XX XX XX 


RPl through RP4 have unique meanings for each type of remote 
terminal. See Tables E2 through E7 of Appendix E. 


SCREECH 
CODE 

XX 


The hexadecimal code (xx) used by CP-V to identify the system 
failure that has occurred. See Appendix C. 


SEEK AMIS 

XXXXXXXX 


A hexadecimal value (xxxxxxxx) representing the physical disk 
address last used to access this device. 


SENSE INFORMATION 

XXXXXXXX XXXXXXXX XXXXXXXX XXXXXXXX 


A hexadecimal value (xxxxxxxx) representing the diagnostic infor- 
mation returned from the device as a result of sending a "sense" order 
to the device. The value has a 4-word maximum, depending on the 
device. 


---SIO- 
STAT CC 

XXXX X 


A hexadecimal value (xxxx) representing the status (STAT) returned 
in response to an SIO instruction, and another hexadecimal value 
(x) representing the condition codes (CC) returned. 


SITE I.D. 
eeeeeeee 


An EBCDIC value (eeeeeeee) identifying the site (specified at 
SYS GEN). 


START 
TYPE 

XX 


A hexadecimal value (xx) indicating the degree of initialization: 

1 - POboot (initial) 

2 - PO boot under the files 

3 - System device boot (no recovery) 

4 - System recovery 

5 - Operator recovery 


SUB 
CODE 

XX 


A hexadecimal code (xx) that differentiates several similar CP-V 
software check codes. See Appendix C. 


SUBC 

STAT -■.-'. 

XX 


A hexadecimal value (xx) representing the status (STAT) of the I/O 
subchannel received as a result of a TDV instruction. The first byte 
of the second word of the status received from the device is: 














indicates bus check fault if set to one. 
indicates control check fault if set to one. 
indicates memory interface error if set to one. 
(Xerox 560 only). 


where 


12 3 

j bi 
bi 
bi 


4 5 6 7' 
t 1 

t2 
t3 



Error Log Listing Processor 73 



Table 33. Error Log Entry Headings (cont.) 



Heading 


Description 


SUBTYPE 

XX 


A hexadecimal value (xx) indicating the type of copy error that 
occurred. Type 01 indicates read error; i.e., the ghost ERR:FIL re- 
ceived an error indication when reading the original error file. 
Type 02 indicates read error end, meaning that subsequent error log 
entries were correctly read from the original error file. Type 03 indi- 
cates a length error; i.e., the original error file record length was 
incorrect. Type 05 indicates incorrect time; i.e., the time of the 
following entry is either out of range or goes backward. Type 06 
indicates illegal entry type; i.e., the type code of the following 
entry was found to be illegal by the ghost ERR:FIL. 


SYMB. 
DCT 

XX 


A hexadecimal value (xx) representing the order in which the sym- 
biont device is configured into the system; i.e., the DCT index of 
the symbiont device. 


SYSTEM 
CP-V eee 


Displays the operating system name (CP-V) and three EBCDIC char- 
acters (eee) representing the system version specified at SYSGEN. 


TDV CUR 
COMM DA 
xxxxxx 

1 


A hexadecimal value (xxxxxx) representing the current command 
doubleword address returned in response to a TDV instruction. The 
address is in doubleword form. Therefore it should be multiplied by 
two to obtain the absolute word location. 


— TDV- 
STAT CC 

XXXX XX 


A hexadecimal value (xxxx) representing the status (STAT), and a 
hexadecimal value (x) representing the condition codes (CC) returned 
in response to a TDV instruction. 


TIME 

hh :mm:ss :rmn 


The time the error occurred, in hours (hh), minutes (mm), seconds (ss), 
and milliseconds (nnn). 


TIME LAST 
DUPLICATE 
hh:rara:ss :nnn 


The time in hours, minutes, seconds, and milliseconds at which the 
last duplicate of the preceding entry occurred. 


TIME LAST 
LOST ENTRY 
hh:mm:ss:nnn 


The time of occurrance when the last entry was lost in hours, min- 
utes, seconds and milliseconds. 


TIME 

RES 

dd 


A decimal value (dd) in milliseconds representing the resolution of 
the time field of all error log entries; e.g., if the time resolution is 
2, then the time value for all error log entries is accurate to two 
milliseconds. 


— -TIO- 
STAT CC 

XXXX X 


A hexadecimal value (xxxx) representing the status (STAT) and a 
hexadecimal value (x) representing the condition codes (CC) returned 
in response to a TIO instruction. 


—TRAPPED— 
INSTRUCT CC 

XXXXXXXX X 


A hexadecimal value (xxxxxxxx) representing the contents of the 
location pointed to by the trapped instruction's address (INSTRUCT) 
in the PSD, and another hexadecimal value (x) representing the trap 
condition codes (CC). 


TRAPPED 

INSTRUCT CC EFF.ADRS 

XXXXXXXX X XXXXXXXX 


A hexadecimal value (xxxxxxxx) representing the contents of the 
location pointed to by the trapped instruction's address (INSTRUCT) 
in the PSD; a hexadecimal value (x) representing the trap condition 
codes (CC); and another hexadecimal value (xxxxxxxx) representing 
the final address (EFF.ADRS) computed for the trapped instruction. 
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Table 33. Error Log Entry Headings (conf.) 



Heading 


• -■ ■ ■ ■ ■ •"-- 

Description 


UN 

XX 


A hexadecimal value (xx) representing the unit portion of the Xerox 
560 unit address. 


UNIT 
NAME 
eeee 


A two-to-four EBCDIC character mnemonic name identifying one of 
the following: CPU; Ml (Memory Interface); PI (Processor Interface); 
MI OP (Multiplexed Input Output Processor); RMP (Rotating Memory 
Processor); CT (Communication Terminator); SU (System Unit). 


USER 
I.D. 
xxxx 


A hexadecimal value (xxxx) which is a unique number assigned by 
the system to the particular job or session. 


USER 
NO. 

XX 


A hexadecimal value (xx) representing the index into internal system 
tables used to access user-specific information. 


VOLUME 
SERIAL 
eeeeee 


Four to six EBCDIC characters (eeeeee) that a user has supplied to 
identify a tape or private disk pack. 


WORKSTATION 

NAME 

eeeeeeee 


A one to eight EBCDIC character name which defines the identity 
and characteristics of a remote station to the system. A workstation 
name is not necessarily associated with one fixed physical terminal. 
The workstation name is specified when the remote terminal logs on. 


message 


An operator message of up to 72 alphabetical characters. 









Table 34. 


RB:FLAGS Structure 


Bit 


Name 


7670 


2780 


IRBT 


Meaning 





BPBIT 


X 


X 




Block protect toggle (ACK0/ACK1). 


1 


IGBIT 


X 


x 


X 


Cards after ! FIN were ignored. 


2 


MORBIT 


X 






Waiting for next portion of deck. 


3 


HUBIT 


X 


X 


X 


Line hung up. 


4 


PUNBIT 


X 






Punching is allowed. 


5 


DCB1T 


X 


X 


X 


WSN specified at SYSGEN. 


6 


HASPBIT 


X 


X 


X 


IRBT line. 


7 . 


SLVBIT 






X 


This system is slave. 


8 


ALBIT 


X 


X 


X 


RBLOG key-in done. 
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Table 34. RB:FLAGS Structure (cont. ) 


Bit 


Name 


7670 


2780 


IRBT 


Meaning 


9 


XP1BIT 






X 


XI specified in Super. 


10 


2780BIT 


X 


X 


X 


2780 line (may be changed to IRBT at logon). 


11 


IBMBIT 






X 


N3 specified in Super. 


12 


DIALBIT 


X 


X 


X 


DIAL specified at SYSGEN. 


13 


EDISBIT 


X 


X 


X 


ERROR MAX on line. 


14 


OFFB1T 


X 


X 


X 


Do not connect line (RBX) - Set except at logon 
for IRBT. 


15 


RBXBIT 


X 


X 


X 


Disconnect line now. 


16 


DUPBIT 


X 


X 


X 


1 —full-duplex; — half-duplex. 


17 


DISC BIT 


X 


X 


X 


Disconnect when output done. 


18 


LOFBIT 


X 


X 


X 


RBDISC sent (temporary setting). 


19 


SYSBIT 


X 


X 


X 


:SYS jobs legal. 


20 


HALBIT 


X 


X 


X 


HOLD all flag set. 


21 


CLKBIT 






X 


Wait before ACKO-tdle. 


22 


ACTBIT 


X 


X 


X 


Line logged on. 


23 


CRTBIT 


X 






RBBAT disables RBSSS. 


24 


XP2B1T 






X 


X2 specified in Super. 


25 


OADBIT 


X 


X 


X 


Set OFFBIT after disconnect. 


26 


FIABIT 


X 


X 


X 


RBCC altered the stream status. 


27 


SSSBIT 


X 






Inputting with output suspended. 


28 


LIPBIT 


X 


X 


X 


Logging on. 


29 


FINBIT 


X 






FIN has been read. 


30 


EMBIT 


X 


X 




1 — NOEM specified; — EM specified. 


31 


OBBIT 






X 


Old BCB was read. 


31 


FRBIT 


X 






Initial read of file. 
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SLIS 

command. 



A sorted, listing is requested with the 
The command has the form 



SLIS 



SL[IS] 



As in the chronological listing, the sorted listing includes 
all qualified error log entries. In this listing, however, 
entries are ordered by their type, and if they are peripheral 
class errors, by their model number and I/O address also. 

Error records are first categorized by ELLA as system, pe- 
ripheral or secondary records, (see Table 05). System records 
and their associated secondaries are listed first. Except for 
the system ID record and configuration record (which are 
printed in front of all other records), system records are 
listed in ascending type code order as given in Table 35. 
Secondary records are printed following their associated 
primary records. 

Peripheral class records are sorted in three phases. They are 
first separated by model number and printed in ascending 
model number order. All peripheral records with the same 
model number are then separated and listed in ascending 



device address order. Finally-, all the records containing 
both the same device address and the same mode! number are 
printed in ascending type code order. Any secondary rec- 
ords associated with peripheral class entries are printed 
following the associated peripheral records. 

Any secondary record. tbat appears in the error file that can- 
not be linked with a primary record through the above rules 
of association wiilbe printed after all peripheral records 
and their associated secondaries under the heading 

>»UNASSOCIATED SECOND ARIES<« 

Each time a record is listed that has a different device 
address than that of the preceding record listed, a Model 
Number/Address heading is produced under the heading 

>»MODEL NO. :xxxx I/O ADDRESS; xxxx 

where MODEL NO. is the 4-digit Xerox model number 
designation of the device and I/O ADDRESS is the 4-digit 
(hexadecimal) I/O address of the device. 

An example of a sorted listing is given in Example 4. 



Table 35. Error Log Entry Types 



Name 


Type 
Code 


Description 


System Class 


COPY ERROR 


10 


Recorded as a result of error conditions in the error logging 
mechanism. The particular malfunction is identified in the 
subtype field (see SUBTYPE in Table 32). If the record sub- 
type is 03, 05, or 06, the record is followed by the 64-word 
buffer in which the error occurred. 


PARITY ERROR 


17 


Recorded when program execution is interrupted to loca- 
tion X'56' (MFI) on Sigma 6 or 7 or is trapped to location 
X'4C (parity trap) on Sigma 9 or Xerox 560. 


SYSTEM STARTUP 


18 


Recorded when the system is booted and at each recovery. 


WATCHDOG TIMER 


19 


Recorded when program execution traps to location X'46' 
due to a watchdog timer run-out condition. 


FILE INCONSISTENCY 


1A 


Recorded when the operating system cannotaccess a file in 
the file management system. The code displayed is described 
in Appendix Bof the CP-V/BP Reference Manual, 90 17 64. 


SYMBIONT INCONSISTENCY 


IB 


Recorded when the operating system cannot access a 
symbiont file in the symbiont file management system. 


INSTRUCTION EXCEPTION 


ID 


Recorded when program execution traps to location X'4D' 
on Sigma 9 or Xerox 560 due to an instruction exception 
condition. 


LOST ENTRY 


IE 


Recorded when error log buffering constraints, timing 
considerations, and error detection rates force error log- 
ging to be temporarily suspended or otherwise impossible. 
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Table 35. Error Log Entry Types (cont. ) 



Name 


Type 
Code 


Description 


System Glass (ct>nf.) 


POWER ON 


20 


Recorded when the hardware power monitor forces 
program execution to trap to location X'51 1 as a result 
of detecting a restoration of power condition. This 
normally occurs as a result of a power outage of 500 
milliseconds or more induration. 


CONFIGURATION 


21 


Peripheral device configuration data recorded when 
ERRFILE is entered. 


SYSTEM IDENTIFICATION 


22 


System information recorded when ERRFILE is entered. 


TIME STAMP 


23 


The date and time which is recorded when ERRFILE is 
entered in the system and every hour on the hour. 


BAD GRANULE RELEASE 


24 


Recorded when either csbad disk address has been de- 
tected or when the granule to be released is already free 
(dual allocation). 


REMOTE PROCESSING 
ERROR 


26 


Recorded when an error is detected in the transmission of 
data to or from a remote processing workstation. 


OPERATOR MESSAGE 


27 


A message entered by the operator through use of the 
ERSEND key-in. 


PROCESSOR FAULT INTERRUPT 


30 


Recorded when there is a processor fault interrupt (loca- 
tion X'56') on the Xerox 560. 


MEMORY FAULT INTERRUPT 


31 


Recorded when there is a memory fault interrupt (loca- 
tion X'57') on Sigma 9 or Xerox 560. 


PROCESSOR CONFIGURATION 


41 


Processor configuration from Configuration Control Panel 
(Xerox 560 only) recorded when the system is booted. 


ENQUEUE TABLE OVERFLOW 


50 


Recorded to log specific information after the operating 
system has detected an enqueue table overflow condition. 


UNKNOWN TYPE = xx 


XX 


An unknown type code xx has been encountered by ELLA 
in an error log entry. 




Peripherc 


il Class 


SIO FAILURE 


11 


Recorded when the condition codes returned by the SIO 
instruction are such that either CClor CC2are true. Con- 
ditions that indicate IOP busy, or lack of operator action 
such as "device manual" may not be considered an error 
condition (and in such case will not be recorded). 


DEVICE TIMEOUT 


12 


Recorded when the time-out value specified by DCT1 1 
has been exceeded. 



78 Error Log Listing Processor 



Table 35. Error Log Entry Types j[cont. ) 



Name 


Type 
Code 


, Description 


Peripheral Ci ass (cont. ) 


UNEXP. INTERRUPT 


13 


Recorded when no match can be found be4ween the I/O 
address returned in the status register by the AIO instruc- 
tion and any DCT1 I/O address of a device known to be 
busy. AIO CC = llxx will not be logged. 


DEVICE ERROR 


15 


Recorded when an I/O request is not successful upon one 
of the specified number of retries. (It may or may not 
have eventually been successful. ) 


PARTITIONED RESOURCE *. 


51 


Recorded when a resource has been partitioned from the 
system. 


RETURNED RESOURCE 


52 


Recorded when a previously partitioned resource has been 
returned to the system. 


Secondary Data Class 


DEVICE ERROR 
SECONDARY 


16 


Recorded when nonzero sense data is available following 
a device error. 


DUPLICATE ENTRIES 


IF 


Recorded when the error logging mechanism detects 
Identical consecutive errors. This prevents the error log 
from becoming saturated with redundant information. 


SECONDARY POLL 
RECORD 


32 


Recorded for each nonzero poll status received by the 
processor polling routines. 


MEMORY PARITY 
SECONDARY 


42 


Recorded for each memory unit that has recorded an error 
as determined by the memory polling routines (i.e., bits 22- 
31 of status word zero are nonzero) for Xerox 560. 


MEMORY PARITY 
SECONDARY 


43 


Recorded for each memory unit that has recorded an error as 
determined by the memory polling routines (i.e., bits 22- 
31 of status word zero are nonzero) for Sigma 9. 


MEMORY PARITY 
SECONDARY 


44 


Recorded to log specific information obtained by scan- 
ning memory to attempt to isolate locations which cannot 
sustain correct parity. 


MEMORY PARITY 
SECONDARY , 


49 


Recorded to log specific information obtained by mem- 
ory polling routines for all machines, including infor- 
mation used to attempt to isolate locations which 
cannot sustain correct parity. 1 



Example 4. Use of the SLIS Command 



For this example, the following batch job deck was submitted. 



| IFIN 
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In the resultant sorted listing below, oil related entries are grouped together.. This facilitates the" scanning of the 
error log that is necessary in order to determine the' common characteristics of related failures that have* , occurred 
Oyef a period of time. f ' % 

Note the OPERATOR MESSAGE entry in the listing. Such messages can be entered into the error log at the 
operator's console by means of the ERSEND key-in. (S?>e the CP-V/OPS Referervcf Manual, 90 16 75.) 



♦slis 



SORTED LISTING 



FROM 07/10/74 12t00i00«000 
TO 12/31/99 23i59«59»999 



♦♦• FILE INCONSISTENCY ••♦ 

DCT 
TIME ACCOUNT INDEX 

16i03«13t648 771731 09 
16t42t32t197 771731 09 



RELATIVE 
SECT ADRS 
0110 
0110 



ERROR 
MODE ORG CODE 
01 02 757F 
01 02 757r 



-— riLE NAME- 

RTRTEXT«V113 
RTRTEXTtV113 



••• TIME STAMP ♦♦♦ 

•♦♦ TIME STAMP ♦♦♦ 

•*• TIME STAMP ♦♦♦ 

•♦• TIME STAMP •*♦ 

*•♦ TIME STAMP •♦♦ 



DATE-07/10/74 
DATE-07/10/74 
DATE-07/10/74 
DATE-07/10/74 
DATE-07/10/74 



TIME-12iOOtO0lO04 
TIME-I3t00»00t004 
TIKE-14i00i00i004 
TIMB«15tOOiOOi004 
TIME-16iO0iO0t006 



•♦♦OPERATOR MESSAGE*" TIME - 14j22»03t782 
9TA81 CAPSTAN DRIVE NOISY (JDR) 



>>> MODEL NOt7160 I/O ADDRESS t0004 «< 



•♦♦ SIO FAILURE *•* 

SIO- TDV- SUBC 

TIME STAT CC STAT CC STAT 

07t02t28i922 2A42 6 2042 6 00 

15t05t21i166 2A42 6 2042 6 00 



TDV CUR REM 

COMM DA BYTES MFI 

001179 004C 00 

001179 004C 00 



*♦♦ DEVICE ERROR ♦♦* 

AIO- 

TIME STAT CC 

15t09»20>862 0048 6 



T IO- TDV- TDV CUR REM ~>' I/O 

STAT CC STAT OC COMM DA BYTES MFI COUNT 
1842 2042 2 00118B 0000 00 04000009*4 



_CUR COMM DW RETRY- VOLUME SUBC 

1 2 REQ REM SERIAL STAT SEEK ADRS 
09008C70 2E000078 03 03 00 OOOOOOOB 



»> MODEL NOi7271 I/O ADDRESS »OOE0 «< 

♦•♦ DEVICE ERROR ♦♦* 

AIO- TIO- TDV- 

TIME STAT CC STAT CC STAT CC 

12i56i21i278 0458 6 1842 0442 2 

15:42i55»694 0458 6 1842 0442 2 

15:«2:55t906 0458 6 1842 0442 2 

... DEVICE ERROR SECONDARY 

I/O 

ADRS 

00E0 

00E0 

00EO 



TDV CUR 
COHM DA 
001 1C7 
000A7E 
000A7E 



REM 

BYTES 

0000 

0000 

0000 



I/O 

MFI COUNT 
00 0000089148 
00 0000138032 
00 0000138036 



CUR COMM DW RETRY- VOLUME SUBC 

1 2 REQ REM SERIAL STAT SEEK ADRS 
02031800 1E000800 03 03 00 OOr9OA0O 

02075800 1E000570 08 08 00 OOE70404 

02075800 1E000570 08 07 00 OOE70404 



TIME 

12t56t21i284 
15i»2i55i700 
15i«2i55»910 



SENSE INFORMATION 

00F90A02 0305F500 OOCA000O 00000000 
00E70500 0119FA02 80CAO0OO 00000000 
00E70500 0119FA0E 03E20000 00000000 



80 Error Log Listing Processor 



SUM The* SUM command requests a summary of the 

con t «n!i of the error file which Jists th« total number (in 
decimal) of Qualified error log entries for each error^type. 
The command ha$ the form 

SUIM] 

In addition to error totals, the summary contains an I/O 
activity count for each device that has errors recorded*. 
IO ACTIVITY is the count of all SIOs issued to a given * 
device for the time period covered by the summary. 



Unlika other listings produced by ELLA, logical device 
addreues are used in the summary rather than physical ddV 
dresses, for example, a device CRAQ3 would appear as 
A03 and a dey we PGBFO would appear as BFO. ; 



On systems with MOS memory, the summary includes MOS 
memory single bit correctable errors (SBCEs). 



Example 5 provides an example of the SUM command. 



Example 5. Use of the SUM Command 



IELLA© 
*SUM© 














ERROR S U 


M M A R 


Y 








FROM 
TO 


07/10/74 
12/31/99 


' 66 i oo i 

23:59: 


00 i 000 
59:999 








SYSTEM 


ERRORS 












TYPE ERRORS 
SYSTEM STARTUP 1 
CONFIGURATION 6 
SYSTEM I.D. 1 
TIME STAMP 16 
FILE INCONSISTENCY 2 








DEVICE 


ERRORS 










. 


MDL 
7140 
; 7160 
7322 
7323 
7323 
7323 
7271 
7232 


IO SIO UNEXP 
ADRS FAIL INTRPT 
A03 
A04 
A80 6 
A8 3 3 
A84 
A85 
AEO 
BFO 


DEV 

ERROR 
13 
6 
78 
3 
4 
6 
3 
2 


DEV 
TIMEOUT 


















IO 

ACTIVITY 
0000014798 
0000004906 
0000227574 
0000018295 
0000021926 
********** 

0000161268 
0000248749 


MOS CORRECTABLE 


ERRORS 










BANK 
A 
C 


UNIT 




UNIT 1 
10 
1 










TOTAL 


ERRORS: 


00144 











DISP The OISP command requests a graphical display 

of error log entries. The DISP command has the form 

Dl[SPJ[, interval] 

where interval specifies the time interval, in minutes, to be 
used for the graph. The interval specified may range from 1 
to 60. The default interval is ten minutes. 

The graph produced by the DISP command is a bar graph. 
Each line begins with the end time of the interval, followed 
by the 2-digit error type code of each error recorded during 



the interval. If the number of errors for a given interval 
exceeds 30, then only the first 30 error type codes are 
printed, and FF is printed at the end of the line. 

Only qualified error log entries are included. Time Stamp, 
Configuration, and ID entries are always excluded. 

The first and last lines in the graph are the first and last 
intervals within the TIME boundary that contains qualified 
error log entries. The actual time period scanned is printed 
at the beginning of the listing. 

An example of a graphic display is given in Example 6. 
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Example 6. Use of D1SP Command 



The user in Example 5 continues as follows: 

*nisp,i»5f!v) 

GRAPHIC D ISP LAY 



FROM 00/00/00 00:00:00:000 
TO 12/31/99 23:59:59:999 



Tinn ERROR 



03:56 15 



•10- 



•20- 



•30- 



04:41 
05:26 
06:11 
06:56 
07:41 
08:26 
09:11 
09:56 
10:11 
11:26 
12:11 



1A1A 



15161515161615111516 
mil 1215151 11515 
15 



2715 



EIJD OP FILE 



The distribution of errors over the scanned time period is more readily apparent in this display than in the other forms 
of error listings. This display is used to check for patterns and trends in error occurrences. The digits that form this 
bar graph are in pairs, (e.g., the line 1B1 1 12151511 1515 contains eight digit pairs). Each digit pair represents one 
error and the two digits are the type code of the error. 



EHD The END command terminates ELLA and exits to 

the monitor. The format of the command is 

E[ND] 



BOUNDARY COMMANDS 

The boundary commands are used to select specified portions 
of the error file for display. In order for an error record to 
be accepted for display, it must satisfy each boundary. 
There are four boundaries: 

• Time 

e Model number 

• Device address 

o Error type code 

An error log entry will be listed by a subsequent task com- 
mand if it was recorded within the time limits specified by 



the TIME command and if it has one of the error type codes 
specified by the TYPE command. If the entry is a peripheral 
class entry (see Table 33), it must also have a model number 
field and an address field which agrees with one of the model 
numbers and one of the device addresses specified by the 
MOD and DEV commands respectively. 

It is not necessary, however, to use any of the boundary 
commands. If a boundary command is not used or a boundary 
has been reset, all error log entries are considered to have 
met the conditions of display for that boundary. 

Boundary commands, if judiciously used, can be especially 
helpful in minimizing ELLA output when the output listing 
function has been assigned to a slow speed device such asan 
on-line terminal. 

RSET The RSET command resets all boundary parameters 

to their default values. (The default values are given in the 
subsequent boundary command descriptions. ) The RSET com- 
mand has the form 

R[SET] 



82 



Error Log Listing Processor 



TIME The TIME command sets 'both date end time 

boundaries. Error fog entries are displayed only if they 
occurred between the begin Sate and time and the .end dafe 
and time. The TIME command has the form 

Tl[ME][,begin][-end] 

where begin and end have the form 

[month/day/yearj[, hounminute] 



or 



[hour :m inure) [, month/day/year) 
where 

month = 1-12 

day = 1-31 

year = 01-99 

hour = 00-23 (24 hour clock) 

minute = 00-59 



If the TIME command is. not used (or if time and date are 
reset by the RSET command) ELLA establishes the following 
beginning and ending times: 

begin = 00/00/00,. 00:00 

end = 12/31/99, one millisecond before midnight. 
(The time is recorded internally in millisecond 
increments. ) 

If only one group (i.e., 'begin' or 'end') is entered under 
the TIME command, the current state of the other group re- 
mains in affect. 

It is not necessary for both fields within a group to be 
entered. If time is the only field entered in a group, then 
the date for that grou p is the current day by default. Time 
by default is a bit more complex. If the date field is the 
only field entered for 'begin', then 00:00 is the time by de- 
fault. If the date field is the only field entered for 'end' 
then 1 millisecond before midnight is the time by default. 

Examples of the TIME command are given in Example 7. 



Example 7. TIME Command Usage 



The following series demonstrates TIME command usage. Assume all of the TIME entries have been entered consecu- 
tively at the console. 

*TIME, 4/25/73-5/27/73© 

The time limits have been set by the entry above as follows: starting time is 00:00 on 4/25/73, and ending time in 
one millisecond before midnight on 5/27/73. The only error log entries that will be displayed by subsequent task 
commands are those that lie between these two time points. 

niME, 2:00- 8:00 © 

The limits have now changed so that the starting time is 2:00 AM on the current day (i.e., the day on which the ELLA 
run is being made), and ending time is 6:00 PM on the current day. (When no date is entered, the current date is 
implied.) 

niME, 18:00-10:00© 

This entry is illegal and will produce a diagnostic message because the starting time is later than the ending time. 
The limits 2:00 and 18:00 from the previous entry are still in effect. 

*TIME 00:00 © 

Here the starting time has been changed to 00:00 on the current day. Since no ending time has been entered, the 
previous ending time of 18:00 remains In effect. 

niME, 1/1/74-12:00© 

This sets the starting limit to 00:00 on 1 January 1974, and the ending limit to noon on the current day. 

*TIME # - 13:00© 
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The previously entered starting limits (1/1/74) remain in effect because no starting parameter Is entered here. The 
ending limit is changed to 13:00 for the current day, 

*RSET© 

ELLA time defaults are reestablished. The default is the entire time span of the error Jog. 

j^TIME, 12:00, 10/15/73-10/16/73, 12:00© 

Finally, the starting time is set to noon on 10/15/73 and the ending limit to noon on 10/16/73. Note that the order 
of time and date entry is immaterial. 



TYPE The TYPE command allows the user to select 

error log entries for display by specifying an error record 
type code (see Table 33). The TYPE command has the form 

TY[PE],{° . . -,} 
J/ Uype 1 [,...rype 5 ]j 

where 

type is a hexadecimal error type code. 

specifies that the default (all types) is to be 
reestablished. 

If error log entry types have been specified via the TYPE 
command, error log entries are displayed only if they have 
a type code equal to one of the types specified. Up to five 
types may be specified for display at one time. 

If the TYPE command is not used, records of all types are 
displayed (including any records that may have illegal type 
codes). Displaying all types is the default condition. Hav- 
ing once used the TYPE command, the default condition 
may be reestablished by entering TYPE, or by using the 
RSET command. 

Each time the TYPE command is used, the previoualy spe- 
cified types are replaced with the newly entered types. 

DEV The DEV command selects error log entries for 

display by specifying up to five I/O addresses. The DEV 
command has the form 



DE 



where 



M£ 



address. [, . . .address-] 



address is a 1 to 4— digit hexadecimal physical I/O 
address. (Leading zeros in the address need not be 
specified.) 

specifies that the default (all devices) is to be 
reestablished. 

Up to five physical I/O addresses may be specified. Each 
time the DEV command is used, the previously specified ad- 
dresses are replaced with the newly entered addresses. 

If this command is not used, records are displayed without 
regard to their associated device address. This is the default 



condition. Having once used the DEV command, the default 
condition may be reestablished by entering DEV, or by 
using the RSET command. 

When particular device addresses have been specified through 
use of the DEV command, error log entries classified as sys- 
tem records (see Table 33) are not displayed, and a peripheral 
class entry is displayed only if the device address field in 
that entry is equal to one of the addresses specified by the 
DEV command. 

MOD The MOD command selects error log entries for 

display by specifying up to five model numbers. When par- 
ticular model numbers have been specified through use of 
the MOD command, error log entries classified as system 
records (see Table 33) are not displayed, and a peripheral 
class entry is displayed only if the model number associated 
with that record is equal to one of the model numbers spe- 
cified by the MOD command. The MOD command has the 
form 



M 



where 



[OD],{ 







model .[", . . .modeL] 



model is a 4— digit model number (e.g., 7446, 7271). 

specifies that the default (all models) is to be 
reestablished. 

Each time the MOD command is used, the previously spe- 
cified model numbers are replaced with the newly entered 
model numbers. 

If this command is not used, records are displayed regardless 
of their associated model number. This is the default con- 
dition. Having once used the MOD command, the default 
condition may be reestablished by entering MOD, or by 
using the RSET command. 

Examples 8 through 12 demonstrate the use of the MOD, 
DEV, and TYPE commands for selecting specific portions of 
ERRFILE for display. The examples are consecutive portions 
of one continuous on-line session. In these examples, the 
user has chosen to display everything at the terminal. This 
means that the user will be able to see the output immedi- 
ately, but the user must make judicious use of this rather 
slow output device. 
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Example 8. Use of the MOD, DEV, and TYPE Commands 



Assume that the user 
step). The user then 


had already requested and received a summary of the error file (which 
proceeded to display the operator messages present in the error file. 


would be a 


logical first 


♦TYPE, 27© 
*CLIS © 












C II R N LO GI.CAL LISTING 










TYPE =27 

FROM 00/00/00 

TO 12/31/99 


00:00:00;000 
23:59 :59: ! -99 










*** OPERATOR MESSAGE *** TIME = 12: 
9TA81 CAPTSTAN NOISY (JBR) 


33:00:079 








Note that the TYPE 


Darameter is listed at the beginning 


of the display because TYPE is no 


longer set to 


the 


default. 


Because only one type of error was requested, the terminal is a practical display device, 
error is requested, a slightly different procedure can be used as shown in the next example 


If more than 


one 


type of 



Example 9. Use of the MOD, DEV, and TYPE Commands 



The user from the previous example next desired to examine some system failures. Note that the new TYPEs entered 
in this example replace the old TYPE entered in the previous example. 

When more than one type of error is requested, a sorted listing often reduces the time required for output. This is due 
to the fact that ELLA only prints headings when a new type of entry is to be listed and SLIS groups all related entries 
together. 

*TYPE,18,1B© 
*SLIS© 



SORTED LISTING 



TYPE =18 1B 
FROM 00/00/00 
TO 12/31/99 



00:00:00:000 
23:59:59:999 



*** SYSTEM STARTUP *** 







START 


RECOV 


SCREECH 


SUB- 


TIME 


DATE 


TYPE 


COUNT 


CODE 


CODE 


09:32:00:000 


07/10/74 


04 


01 


19 


00 


12:05:00:000 


07/10/74 


01 


01 


00 


00 


17:21:00:000 


07/10/74 


05 


02 


00 


00 



***SYMBIONT INCONSISTENCY*** 

DCT REL. SYMB. 
TIME INDEX SECT. DCT 

11:29:08:406 09 OOA0 02 
16:03:13:648 09 0110 02 
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Example 10. Use of the MOD, DEV, and TYPE Commands 



The user proceeded as follows: 



jTYPE, 17© 
*DEV, 1F0© 
~CL1S© 



No output was produced because TYPE, 17 and DEV X'IFO' are mutually exclusive. Type 17 (Parity Error) is a system 
class error while device X'IFO 1 implies that peripheral class errors are desired. Entering either MOD or DEV values 
precludes the display of any system errors (only peripheral class errors will have model or device address information, 
and all four boundaries tests -MOD, DEV, TYPE, and TIME -must be passed for an error log entry to be displayed). 



Example 11. Use of the MOD, DEV, and TYPE Commands 



The user next decided to examine SIO failures on several devices. 




, ■■ 


♦TYPE ,11© 






♦DEV, 4, 81, 82,83© 






♦CLIS© 






CHRONOLOGICAL LISTING 






TYPE =11 






DEV =0004 0081 0082 0083 






FROM 00/00/00 00:00:00:000 






TO 12/31/99 23:59:59:999 






♦*♦ SIO FAILURE *** 






I/O SIO- TDV- SUBC 


TDV CUR 


REM 


TIME MDL ADRS STAT CC STAT CC STAT 


COMM DA 


BYTES MFI 


12:36:30:782 7323 0083 2000 6 1000 6 00 


0011B7 


0001 00 


12:37:29:518 7323 0083 2000 6 1000 6 00 


0011B7 


0001 00 


12:40:10:398 7323 0083 2000 6 1000 6 00 


0011B7 


0001 00 


♦♦BREAK 

* 






After examining several of the failures on device X'0083 1 , the user realized that no new information would be gained 


by listing the remaining errors. Therefore, the user interrupted the listing process by 


activating the BREAK key at the 


terminal. 
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Example 12. Use of the, MOD, DEV, and TYPE Commands 



Finally, the user summarized, in graphic form, all Mode! 7322 and 7323 failures that occurred on the current day. 

♦DEV, 0-0 

♦TYPE,0© 

♦MOD, 7322,7323© 

♦TIME, 00: 01© 

♦DISP© 



GRAPHIC DISPLAY 



MODL =7322 7323 

FROM 02/09/74 00 : 00x00? 000 

TO 12/31/99 23:59:59:999 



TIME ERROR 



09:11 11 

09:21 

09:31 

09:11 

09:51 

10:01 

10:11 

10:21 

10:31 

10:H1 

10:51 

11:01 

11:11 

11:21 

11:31 

11 til 

11:51 

12:01 

12:11 

12:21 

12:31 1516 

END OF FILE 



■10> 



•20- 



■30- 



1516151516161115151616 
1315161516 



DSPL. The DSPL command displays the current state of 

those ELLA parameters that are alterable by the boundary 
commands. The date and time boundaries are always listed 
by this command. Each of the remaining boundaries will 
also be listed unless its current state is its default state. 

The DSPL output is printed both on the output listing device 
and the command input device. In batch operation, DSPL 



output is only directed to the output listing device since 
the input device is the card reader. 

The format of the command is 

ds[pl] 

An example of the command is given in Example 13. 
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Example 13. Parameter Display 



The on-line user may check the current state of the ELLA boundaries conveniently with the DSPL command. If the 
I Utiag device has been assigned to a line printer, the boundary information will be displayed on both the line printer 
and the user's, terminal, < ' ♦ *'■ 



i" . 



*RSET© , - 

*SET,LIST,LP© 

^DSPL® 

FROM 00/00/00 00:00:00:000 

TO 12/31/99 23:59:59:999 

*TYPE,11,12,15© 

*DEV,E1© 

*DSPL© 

TYPE =11 12 15 

D EV-=00E 1 

FROM 00/00/00 00:00:00:000 

TO 12/31/99 23:59:59:999 



MOS On MOS memory systems the MOS command 

prints a graphic display of all MOS-memory reported 
single-bit correctable errors (SBCEs). These errors are 
logged as MFI (30) and Memory Parity Secondary (43) 
errors, and are summarized in a special fashion with the 
MOS command . i 



The format of the command is 
MOS, 



ALL \ 
it/bank j 



where 



ALL implies that SBCEs for ALL BANKS are 

to be reported. 



Example 13.1. MOS Summary Display 



unit/bank implies that SBCEs for the selected 
unit/bank are to be reported, where 

unit = or 1 

bank = A,B,Cor D. 



The MOS single-bit thresholding and reporting is under 
CONTROL control. 



An example of the MOS command Is given in 
Example 13.1 . 



*MOS, ALL 
































MOS C 


O 


R R E 


C 1 


' A 


3 L E 


E 


R R 


O 


R S 














FROM 00/00/00 


oc 


:00 


:00:000 






















TO 12/31/99 


22 


:59 


:59:999 






















UNIT 1 
































BANK A 






























--> 


SLOT 




A 


B 




C 


D 




F 




G 




H 




J 




CHIP- 1 









3 






























-31 






















2 














o 


-51 





































1 


-71 












O 









4 









O 







UNIT 1 
































BANK C 






























--> 


SLOT 




A 


B 




C 


D 




F 




G 




H 




J 




CHIP- 51 






















1 
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PRCPEFIKEP TASKS 



This section contains a set of predefined tasks that should 
be useful to the person* who needs periodic error log reports, 
but has no need for a more precise knowledge of tneHLLA 



processor's command structure. These tasks could be main- 
tained as job decks (as illustrated here), or the^cOYrimarrds 
.might* be entered into a file to facilitate, 'on-line sobmissian 
to the batch stream (see the TEL BATCH command in the 
CP-VAS Reference Manual, 9009117): The account from 
which these jobs are run must have" a diagnostic privilege 
level (A0 or higher). The tasks are listed in Examples ]4 
through 16. 



Example 14. Listing the Entire Error File 



The following deck obtains an error summary and a chronological listing of the entire contents of the error file. 



IFIN 



END 



CLIS 



SUM 



1 1ELLA 



I JOB account, name, priority 
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(This pago intentionally left blank.) 



88.2 Error Log Listing Processor 90 31 138-2(9/78) 



Example 15. Listing Errors for the Current Day 



The following job deck "obtains an error summary, a chronological listing, and a sorted listing of the errors recorded 
by the system on the current -day.' If error log reports are to fee obtained daily, it is recommended that this job be run 
at the end of the processing day. . 



!FIN 



END 



SLIS 



CLIS 



SUM 



TIME, 00:00 



!ELLA 



!JOB account, name, priority 



:nr\ 



Example 16. Listing Start-Ups, Configuration, and Device Partitioning Activity 



The following job deck obtains all the configuration data together with system start-up, partitioned resource, and 
returned resource entries in chronological order. 



!FIN 



END 



CLIS 



TYPE, 18,21,22,51,52 



IELLA 



UOB account, name, priority 
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ELL& MESSAGES 



RiAXOFiflftiARD SUMMARY 



Messages output by the ELLA processor are listed in 
Tabie 36. 



ELLA commands are summarized jn Table 37. The left-hand 
side lists the command formats*. ' The right-hand side de- 
scribes the funct'on of the command. 



Table 36. ELLA Messages 



Message 


Meaning 


ABNORMAL ERROR CODE - xx 
SUBCODE = xx 


An abnormal condition was detected in issuing a system CAL. 
The abnormal code and subcode are described in the CP-V/BP 
Reference Manual, 90 17 64, (and the CP-V/TS Reference 
Manual, 90 09 07). See the system analyst. 


BREAK 


The BREAK key was depressed. ELLA stops processing and waits 
for a new command. 


ELLA 708006- A00 


This heading is output when ELLA is first loaded. 


ERRFILE IS BUSY, WILL TRY AGAIN 


ELLA tried to access the error log file and found it busy. 


**ERRLOG NON-EXISTENT 


The ERRFILE file does not exist. See the system analyst. 


ERROR IN KEY FORMAT 

(YEAR/DATE NOT IN PACK DECIMAL) 


An ERRFILE entry had an erroneous key* See the system analyst. 


ERROR IN SYSTEM TIME 


The time in the error log file was not logical. See the system ' 
analyst. 


ERROR OCCURRED: CODE = xx 
SUBCODE = xx 


An error was detected in issuing a system CAL. The error code 
and subcode are described in the CP-V/BP Reference Manual, 
90 17 64, (and the CP-VAS Reference Manual, 90 09 07). See 
the system analyst. 


ERROR: TIME.GT. 
99:59:59:999 


The time in an error log entry was greater than 99 hours, 59 
minutes, 59seconds, or 999 milliseconds. Seethe system analyst. 


ERROR: TOO MANY CHARACTERS OR • 
LINES 


ELLA tried to output more than 132 characters to the line printer. 
. See the system analyst. 


INSUFFICIENT PRIVILEGE LEVEL ABORT 


ELLA requires an A0 or higher privilege level. 


INVALID REQUEST 


The command entered was invalid. 


NON-REASSIGNABLE 


Once the operator's console is assigned as the control device, it 
cannot be reassigned. 


NOTHING IN ERRFILE 


ERRFILE does not contain any records. 


**OVERFLOW OF SORT OR MOD/IO 
TABLES 


ELLA will only support 50 unique I/O addresses. Use the 
boundary commands to restrict the number of I/O addresses. 


UNABLE TO LOAD SEGMENT = nn 


ELLA tried to load overlay number nn and an error was detected. 
See the system analyst. 
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Table 37. . ELLA Command Summary 



Format 


"'"" " 1 
Description 


C[LIS] 


Requests a chronological listing of the error entries in ffis order 
in which they appear in ERRF I LE. . 


DE[V],{°. , V M .} 
laddresSj[, ..., address- J J 


Selects error log entries for display by specifying up to five 
physical device I/O addresses or (if is specified) specifies that 
error log entries for all devices are to be displayed. 


Dl[SP] [, interval] , 


Requests a graphical display of error log entries. 


DS[PL] 


Displays the current state of the four types of boundaries. 


E[ND] 


Terminates ELLA and exits to the monitor. 


M[OD] ' (model ,[,... .modeg} 


Selects error log entries for display by specifying up to five model 
numbers or (if is specified) specifies that error log entries forall 
models are to be displayed. 


R[SET] 


Resets all boundary parameters to their default values. 


SET, LIST, {J^} 


Reassigns the listing and message output device assignment during 
execution of ELLA. LP specifies line printer. KP specifies oper- 
ator's console for the ghost and batch modes and on-line terminal 
for the on-line mode. 


SL[IS] 


Requests a sorted listing of the error log entries. 


- $U[M] 


Requests a summary of the contents of the error file which lists 
the total number (in decimal) of error log entries for each error 
type. 


Tl[ME][,begIn][-end] 


Sets both the date and time boundaries where begin and end have 
the form 

[month/day/yearJ[, hourrminute} 

or 
[hour:minute]Q month/day/year J 


^M'Ce^,...^]) 


Selects error log entries for display through the specification of 
error record type codes (see Table 33) or (if is specified) 
specifies that all types are to be displayed. 



HARDWARE-ERROtf DIAGNOSTIC CALS 



The following three CALs are intended for use by the monitor 
in performing diagnostic functions relating to the hardware- 
error log and must be issued by a program from the :SYS 
account. They provide the following services: reading from 
the hardware-error log, writing to the hardware-error log, 
and initiation of diagnostic ghost jobs. 



These three services are all invoked by a CAL1,6 fpt in- 
struction; the addressed FPT contains a code and a parameter. 
The FPT codes and the functions performed are as follows: 



FPT Code 


I 
6 



Function 

Read Error Log 
Write Error Log 
Initiate Ghost Job 
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The status of the requested operation is reported via 
condition-code settings summarized below. (Not all of the 
status indicated are appropriate to, or reported by, all 
three CALs.) 

CC-1 CC2 CC3 CC4 Status 

Normal return. 

10 Request denied: insufficient privi- 
lege, not in :SYS account, or buffer 
is not a data page. 

10 Error during operation (Read or 

Write), or job unknown (Initiate). 

10 Last buffer. 

1 Error log does not yet exist (Read) . 

In each case, the calling program must be of privilege level 
CO or greater; otherwise CC1 is set to 1 and no action is 
taken . 



READ ERROR LOG 

The format of the FPT for a read-error- log request is 



XW 



1 2 314 5 6 7 



10 till 



Buffer address 



16 17 18 19120 21 22 23124 25 26 27 i 28 29 30 31 



A variable number of words up to a maximum of 256, de- 
pending upon the contents of the error log, is read to the 
area addressed by the FPT. This is a 'destructive' read, 
returning error- log granules to the monitor's available pool 
as they are exhausted. 

The error- log file is not protected against simultaneous use; 
thus only one program in the entire system should read this 
file. 



WRITE ERROR LOG 
The format of the FPT for a write-error-iog request is 



X'OT 



I 2 3 14 5 6 7 



9 10*" 1 1 12 13 U -15 



Buffer uddress 



16 17 18 19l20 21 22 23i 24 25 26 27! 26 29 30 



The second byte of the data record addressed by the FPT 
must specify the number of words to be written, up to a 
maximum of 253. ' The first byte of the record should con- 
tain a type code. 



INITIATE GHOST JOB 

The format of the three-word FPT for an initiate- job request 
is 

word 



X'06' 



012314567 18 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



words 1 and 2 


(Name of job to be initiated) 






n 


°1 


a 2 


a 3 


a o 
n-3 


°n-2 


Vi 


a 
n 


12 3 14 5 6 7 


8 9 10 111 12 13 14 15 


16 17 18 19>I 20 21 22 23 


24 25 26 27 1 28 29 30 31 



(Name of job must be in TEXTC format.) 

If the program to be initiated is already in execution at the 
time of the request and is not in a waiting state (WAIT CAL 
with unexpired time), the normal return is made (CCI=0). 
If the program is in a waiting state, it will be activated 
immediately at the WAIT CAL plus 1 and a normal return is 
made to the initiating program. 
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7. SHARED PROCESSOR FACILITIES 



INTRODUCTION 

This chapter describes the shared processor facilities of 
CP-V. These facilities permit the sharing of the code for 
compilers, assemblers, command language processors, de- 
buggers, libraries, and other programs among all simulta- 
neous users. 

Shared processors are not limited to programs provided 
by Xerox. The facilities may be effectively used when- 
ever a program has a high probability of common usage. 
Service bureaus, for example, may use the mechanism for 
proprietary packages. Corporate installations may use the 
mechanism for programs with a high use frequency. 

Most programs may be establ ished as shared processors by 
naming them at SYSGENtime. This causes the file copy 
of the program from the :SYS account to be written on the 
swapping disk during system initialization. The program is 
then available through high-speed swapping I/O. 

The file copy of the program is retained for recovery pur- 
poses and may be copied to another account and run as an 
unshared program under Delta for development and debug- 
ging purposes. If the load module in the :SYS account is 
replaced, the shared copy of the program on the sv/apping 
disk is updated to the newer version in the event of a sys- 
tem recovery. 

To qualify as a shared processor, a program must meet cer- 
tain requirements. These requirements are outlined in the 
remainder of this chapter. The most stringent requirement 
relates to the single overlay level that is described in the 
section below titled "Overlay Restrictions". 

To avoid confusion, the use of processor names which re- 
semble monitor mnemonics is discouraged. However, if such 
names are used, the following rules must be followed: 

1. If the first three characters of the processor name are 
JOB, BIN, BCD, EOD, or FIN, then usage of that pro- 
cessor in the batch mode requ ires that at least one blank 
appear between the I and the processor name on the 
control command which calls the processor. 

2. The names of monitor control commands (listed in the 
CP-^BP Reference Manual, 90 17 64) are reserved words 
and must not be used as processor names. 



PUBLIC PROGRAMS 

A program whose load module is in the :SYS account but is 
not shared is a public program in the sense that it may be 
called either by a control card containing the I symbol and 
the program name, or by an entry of the program name in 
response to a TEL prompt (I) for commands. Each user of a 
public program has his own copy of the program. 



PROCESSOR PRIVILEGES 

Processors in the iSYS account and shared processes may be 
granted special privileges which are independent of the 
user's privilege level and are in effect only when the pro- 
cessor is executing. For shared processors, privileges are 
specified on the :SPROCS cqmmand atSYSGENoron the 
DRSP command which enters the processor. Privileges for 
unshared processors are specified when the load module is 
loaded, using the PRIV keyword. The privilege flags be- 
come part of the load module and are invoked when the 
load module is executed. Load module privileges will not 
be granted by the monitor unless the load module resides in 
the :SYS account when it is executed. 

The following privileges are implemented: 

1. Master mode permission — can execute M:SYS or 
M:MASTER CALs. 

2. Maximum memory protection — can exceed user's 
memory limit to a maximum of 92K words. 

3. Special JIT access — allowed write access for JIT page. 

4. Processor accounting— causes CPU time to be subtotaled 
separately from user execution and service time. It 
will be subtotaled as processor execution and service 
time. (This is always done for shared processors. ) 



SHARED PROGRAMS 

Shared programs are called in the same manner as public 
programs. However, each user of a shared program has his 
own copy of only the data and DCB portion of that program; 
the procedure portion is shared by all users associated with 
the shared program. 

There are four distinct kinds of shared programs: 

1. Ordinary shared processors. 

2. Special shared processors. 

3. Shared debuggers. 

4. Public libraries. 

All shared processors must be built by the batch loader. 
Ordinary shared processors occupy the same virtual memory 
as user programs and may not be associated with them. 

Special shared processors, shared debuggers and public li- 
braries occupy (and are overlayed in) the special processor 
area. Figure 11 shows the virtual memory allocation for 
shared programs that are biased within the special processor 
area. Shared debuggers may be associated only with user 
programs; they may not be associated with any other shared 
processors. Public libraries may be associated with user 
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DCBs 
(if any) 


Procedure 



Figure 11. Special Processors — Virtual Memory 



programs or ordinary shared processors; a public library may 
nor be associated with a special shared processor. Note 
that both a shared debugger and a core library may be con- 
currently associated with a user program. This is possible 
because the procedure portion of the debugger and the 
library may be overlayed in the special processor area. 



FIXED F^O&ITOR LOCATIONS 

For certain purposes, such as the choice of an effective core 
allocation technique, it is desirable for processors and olher 
programs to be able to identify the monitor in operation, 
certain critical locations of the monitor, and the location 
of job information table (JIT). This is accomplished by 
having locations 2A, 2B, and 4F common to all Xerox mon- 
itors. Figure 12 illustrates the contents of these locations. 



LOGON C088ECTI0II 

Commonly used programs, such as BASIC, may be colled 
automatically by LOGON. The name of the program to be 
called, which may bo either a shared or public program from 
any accessible account, is established in the user's author- 
ization record by Super. LOGON calls the named program 
for the user following a successful log-on. 



SHARED PROCESSOR PROSRAiiINO 

The programming of shared processors may require certain 
information about the CP-V monitor. This information is 
outlined below. 



Location 2A contains a flag that differentiates between an 
initial boot (nonzero) and a recovery boot (zero). 

Location 2B contains three items: 

1 . Monitor — This field contains the code number of the 
monitor. The codes are as follows: 

Code Monitor 






None or indeterminate 


1 


BCM 


2 


RBM 


3 


RBM -2 


4 


BPM 


5 


BTM/BPM 


6 


UTS ' 


7 


CP-V 


8 


CP-R 


9-F 


Reserved for future use 



2A 



2B 



Boot Flag 



1 2 3 1 4 5 6 7 I S 9 10 111 12 13 14 IS I 14 17 18 l»l 20 21 22 23 1 24 25 26 27I2B 29 30 31 






MONITOR 



Version 



Parameters 



? I 2 314 5 6 718 9 10 111 12 13 14 15116 17 18 19 1 20 21 22 23 1 24 25 24 27I28 29 30 31 



4F #&? x -'. 



1 2 3 14 5 6 7 



J IT Address 



8 9 10 llll2 13 14 15ll6 17 18 19I20 21 22 23I24 25 26 27I28 29 30 31 



Figure 12. Locations Common to All Monitors 
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3. 



Van Ion — This is the version code of the monitor end is 
coded to correspond to the common designation for 
versions. The alphabetic count of the version desig-r 
nation Is the high-order part of the code and the version 
number is the low-order part. For examphf, A00 is 
coded X'10' and D02 Is coded X'42*. 

Parameters — The bits in this field are used to Indicate 
suboptlons of the monitor. They are meaningful only 
In relation to a particular monitor. However, the fol- 
lowing assignments have been made for BPM, BTM, 
and CP-V. 



Bit(s) 
31 set 
30 set 

29 set 
28 set 
27 set 

26 set 



M eaning 

Symbiont routines included. 

Remote processing routines 
included. 

Real-time routines included. 

Unused. 

Reserved for Data Manage- 
ment System. 

Reserved. 



22 reset; 23 set; 24, Computer is Sigma 5. 
25 reset 



22, 23, 24 reset; 
25 set 



Computer is Sigma 6 or 7. 



22, 23 reset; 24 set; Computer is Sigma 9. 
25 reset 



22, 23 reset; 24, 
25 set 

18 set 
17 set 
16 set 



Computer is Xerox 560. 

Multiprocessing capability 
present . 

Transaction processing rou- 
tines included. 

On-line system. 



Location 4F contains the virtual JIT address right-justified. 



JOB INFORMATION TABLE (JIT) 

For each active Job, the system maintains an in-core record 
(job information table) that allows the job to be scheduled 
and swapped. This job information table (JIT) is the first 
page of each Job, both in core and on the swapping disk, 
and contains accounting information, memory map, swap 
storage, addresses, and other information for the job that 
may be of use to a processor. r In order to reference these 

"With respect to accounting, only shared processors or load 
modules with the "processor accounting" privilege are pro- 
cessors, i.e., time spent compiling a COBOL program is 
accounted under "user time" while time spent in FORTRAN, 
PCL, etc., is considered "processor time". 



valuss, the processor should REF: the required symbol and 
then specify that : JO, the JIT definition package, be iottded 
along with the processor. The entire JJT is. avajlablo on a 
read-only basis to all programs including prpgessocs. Con- 
tents that are particuldrly useful to processors ore given in 
Table 38. The complete contents are described in the CP-V 
Data Base Technical Manual, 90 1.9 95. 



Table 38. Partial Contents of JIT 



Location 


Size 


* 

Contents 


J: JIT 




■ — — -"" ■—-——— "^—--"4 


(bit 0) 


1 bit 


Set if the job is on-line end 
reset if the job is batch . 


(bit 1) 


1 bit 


Set if the job is a ghost job. 
For example, the meaning of 
bits and 1 is as follows: 

00 batch job 

01 ghost job 
10 on-line 


(bit 2) 


1 bit 


Set if user is a non-COC 
on-line user. (Bit also 
set.) 


(bit 3) 


1 bit 


Reserved. 


(bit 4) 


1 bit 


User is executing from a 
command file. 


(bits 
16-31) 


halfword 


Job identification number 
that is guaranteed to be uni- 
que to each currently exe- 
cuting job. 


JB:LPP 


byte 


Number of printable lines 
per page (COC). 


JB.-LC 


byte 


Current print line number 
(COC). 


J:OPT 


word 


Option flags set by TEL and 
affected by the 'DON'T' 
modifier. 


JrCCBUF 


20 words 


Image of the command line 
received by TEL. 


JBKXARS 


byte 


Length of command line 
received by TEL. 


J .-USER 


2 words 


On doubieword boundary for 
any use by installation. 


M:UC 


22 words 


Console I/O DCB (system 
DCB). 
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MEMORY SIZE RESTRICTIONS 

Because of certain CP-V Swapper characteristics, the 

?hysical size of shared processors is restricted to 74 pages, 
hat is the maximum size of the processor root and its 
longest overlay, and the procedure size of any associated 
shared library. . ' 



MEMORY CONTROL 

No special memory restrictions apply to programs operating 
as shared processors. In CP-V, as in any other time-shared 
or moltiprogrammed system, prudent use of memory can sub- 
stantially improve system throughput. Requests for all avail- 
able memory should be avoided. A request for enough 
memory to cover typical processing should be made initially, 
then a request for additional memory should be mode during 
processing if the need arises. Memory should be returned to 
the system at major changes of control, but the frequent 
acquisition and release of memory will increase system over- 
head out of proportion to the gain. 

OVERLAY RESTRICTIONS 

Any processor intended for shared use may be created and . 
debugged as an ordinary program. It may be coded in as- 
sembly language and debugged under Delta or created in 
FORTRAN and debugged with FDP. To qualify for inclu- 
sion as a shared processor, it must be coded within the 
following restrictions: 

1. Shared processors are allowed only one level of over- 
lay. There is no restriction on the number of overlays 
but only one of them can be associated at a time. 

2. Data cannot be included in overlays; it must be in the 
processor root. 

3. Overlay names are restricted to seven characters or 
less. 

4. All parts of an overlay disappear from core when an- 
other overlay is called. (Portions of a previously used 
overlay are not available when a shorter overlay is 
invoked. ) 

5. Shared processors written in FORTRAN must be pre- 
ceded by some Meta-Symbol code that associates the 
library and links to the FORTRAN code. 

6. The root must be greater than one page in length. 

When an overlayed shared processor is requested, the pro- 
cessor root and its first overlay are loaded. Assembled data 
and DCBs are loaded when the root is loaded. Whenever 
overlays are not required, memory usage can be held down 
by declaring an overlay length of zero and issuing a CAL to 
associate that overlay. 

Overlays are declared and associated in the same way as 
they are for batch programs (CP-V/BP Reference Manual, 
90 17 64). TREE command cards and M:SEGLD remain the 
same. CSECT 2 and 3 are converted to CSECT 1 by CP-V 
loaders. 



Shared debuggers (Delta is thecnly current example) must 
have only one page of context and no overlays. They re- 
side in the special virtual area of high memory that is cur- 
rently fixed in virtual (not physical) size in the highest 
16K of virtual storage. They may be any physical size less 
than 16K including their context page. 

DATA CONTROL BLOCKS 

Most processor^I/O operations are performed through stan- 
dard monitor DCBs. For example, source input is norm- 
ally read by 

M.-READ M:Sl[options] 

The standard DCBs are 

M:8I 

M:CI 

M:EI 

M:SI 

M:C 

M:BO 

M:CO 

M:DO 

M:EO 

M:LO 

M:SO 

M:PO 

M:AL 

M:LL 

M:OC 

M:SL 

M:GO 



The default assignment of monitor DCBs is the operational 
label of the same name (M:DO is assigned to DO, etc.). 
The default assignment of operational labels to devices is 
shown in Appendix A. These assignments may be changed 
at SYS GEN. The default assignments for batch operations 
differ from those of on-line operations. This is done so that 
a program that writes through LO and reads through SI will 
automatically use the line printer and card reader for batch 
operations and the terminal for on-line operations. The 
logical functions associated with the operational labels ore 
described in the CP-V/BP Reference Manual, 90 17 64. 



Details concerning input buffers, error handling, and so on 
are specified as parameters in a read or write call. Param- 
eters associated with files and devices are specified by the 
ASSIGN (batch) or SET (on-line) control command. 
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A processor may construct its own DCBs by means of the 
M:DCB procedure. However, processors are not required 
to construct DCBs. DCBs" not constructed by a processor 
will be constructed by the loader. Standard DCBs con- 
structed by the loader occupy 51 words and are connected 
to a device either by the loader or by an on-line user by 
means of special terminal commands. The M:DCB procedure 
must be used if optional parameters such as read or write 
accounts exceed the allocation of the standard DCBs 
(Table 39). 

DCBs are also provided in library form arid ma# be explicitly 
called during a load. The sizes of these DfpBS are shown in 
Table 39. 

Processors may use nonstandared DCBs, if necessary. Non- 
standard DCBs are constructed by the loader if not con- 
structed by the processor. They must be explicitly connected 
to a device either by an MtOPEN call in the processor or 
by a SET command issued by an on-line user since no default 
assignment via operational labels is provided. 

It is common practice for a processor to obtain source input 
through M:SI, to print a source listing through M:LO, and 
to print diagnostic output through M:DO. However, pro- 
cessor I/O operations are complicated by the fact that an 
on-line user can connect SI, LO, and DO either to different 
devices or to the same device (the on-line default assign- 
ment for SI, LO, and DO is the terminal). In particular, a 
user may connect twojor more of these standard operational 



labels to the same device. For this reason, processors must 
fake precautions to avoid duplications in printed output. 
This means that processors must know at a! ! times whether 
they were calied in batch or in on-line mod© and what 
spec ificdev ice connections have been mdde for standard 
DCBs. 

Processors may examine DCBs directly to determine when 
the DCBs are connected to the same device. Fields within 
a DC B may be referenced relative to the name of the DCB. 
Fields that may be useful to processors are as follows: 

Field Use 

FCD Bit 10 of word of a DCB. This is the file- 

closed flag. A 1 means the associated file 
is open; a means the file is closed. 

TYPE Bits 18-23 of word 1 of a DCB. These bits 

specify a code for the type of device con- 
nected to the DCB (printer, terminal, card 
reader, etc. ). 

DEV Bits 24-31 of word 1 of a DCB. These bits 

specify an indexto the monitor device table. 

Under CP-V, all device assignments are direct. This means 
that DEV always contains a direct device assignment. A 
complete layout and description of DCBs is contained in the 
CP-V/BP Reference Manual, 90 17 64. 



Table 39. Standard DCBs 



Name 


Device 


Name 


Account 


Pass- 
word 


Expiration 
Date 


Read 
Accounts 


Write 
Accounts 


Execute 
Accounts 


Execute 
Vehicle 


INSNS 


OUTSNS 


Synonymous 
Name 


Key 
Buffer 


Total 
Words 


Loader 

Built 

DCBs 


22 


4 


3 


3 


3 





a 






4 


4 





8 


51 


M:C 


22 


























22 


M:CX: 


22 




















' 






22 


M:BI 


22 


9 


3 


3 


3 
















8 


52 


M:CI 


22 


9 


3 


3 


3 
















8 


52 


M:S1 


22 


9 


3 


3 


3 
















8 


52 


M:EI 


22 


9 


3 


3 


3 


17 


17 


17 


4 






9 


8 


116 


M:BO 


22 


9 


3 


3 


3 


17 


17 












8 


86 


M:CO 


22 


9 


3 


3 


3 


17 


17 












8 


86 


M:SO 


22 


9 


3 


3 


3 


17 


17 












8 


86 


M:PO 


22 


9 


3 


3 


3 
















8 


52 


M:LO 


22 


9 


3 


3 


3 
















8 


52 


M:LL 


22 


9 


3 


3 


3 
















8 


52 


M:DO 


22 


9 


3 


3 


3 
















8 


52 


M.-GO 


22 


9 


3 


3 


3 
















8 


48 


M:EO 


22 


9 


3 


3 


3 


17 


17 


17 


4 


4 




9 


8 


116 


M:SL 


22 


4 


3 


3 


3 
















8 


43 


M-AL 


22 


4 


3 


3 


3 
















8 


43 
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The some effect can be obtained by the CORRES device 
CAL, but the CAL is much slower, than the direct compar- 
ison. The direct comparison qf the combined TYPE-DEV 
fields is meaningful only if the DCS has been opened. This 
means that processors must explicitly open DCBs for which 
device assignments will be tested. 



FILE IDENTIFICATION f 

All on-line processors use a common format and .common 
character set for constructing file identifiers (fid). The 
standard format is 



".account "1 

. account, password I 

...password J 



where name, account, and password consist of character 
strings with maximum lengths of 11, 8, and 8, respectively 
(name has a maximum of 13 characters for CC1, Edit, and 
PCL and a maximum of 10 characters for Link and Load). 
Any of the following characters may be used: 



A-2 



0-9 L_J $ 



% 



Lowercase alphabetical characters are not available on all 
terminals (e.g., Teletype Models 33 and 35). If lowercase 
letters are sent to these terminals, they are printed in upper 
case. 

Account and password are optional. If account is omitted, 
the log-on account is the default account. If password is 
omitted, no password is required to access the file. 



TEL SCAN 



rom specifies that the relocatable object module 
produced by the processor is to be directed to a 
specified file (fid). If no file is specified, out- 
put is directed to a special file that may be sub- 
sequently referenced by a dollar sign. 

list specifies that a file (fid), a line printer (LP), 
or the terminal (ME) should be used for listing. 
If list is not specified, no listing output is 
produced. 

These specifications are implicit ASSIGN and SETcommands 
for the DCBs MjSI, M:GO, and M:LO. A processor call 
causes the specifiedprocessortobe executed with M:SI DCB 
input from the file sp. Processor output through M:GO DCB 
is placed in the file specified by "rom" and listing output 
(M:LO DCB) is directed to the file or device specified 
by "list". Processor calls are interpreted by TEL. 

Parts of a processor calf may be enclosed in parentheses. 
TEL does not do anything to these parts of a processor call. 
However, the processor may examine these and other parts 
of the command line that is in its JIT buffer (JrCCBUF). 

Processors may reside in storage in three forms: 

1. System swap storage contains absolute shared copies 
of frequently-used processors. These copies can 
be located and loaded quickly. The absolute shared 
processor file is created during system initialization and 
contains reentrant processors that are shared among 
all concurrent users. 



2. The :SYS account may also contain copies of processors 
in load module form. Processors in this form cannot be 
loaded as quickly as absolute processors, but therSYS 
account may be useful during processor construction, 
debugging, and extension. Public programs in the 
:SYS account may be called by entering their names in 
TEL commands or on control cards. 



A processor call entered through a terminal via TEL has the 
form 



whe 



lm[ s p][pvER [ rom l[/ , ' s 0j 



Im is the name of the processor and is a file identi- 

fication (fid). Account :SYS is assumed. 

sp specifies a source program and may be either a 
file identification (fid) or a terminal identifica- 
tion (ME). 

ON indicates that ROM output is to be on a new 
file. 

OVER indicates that ROM output is to be over an 
existing file. 



3. A user may store his own processors or his copies of 
system processors in his own files (account). A pro- 
cessor stored in a user's file area is identified by its 
file name and may be called by the RUN command 
in batch or START command in on-line operations. 



When TEL encounters a processor call, it issues an exit CAL 
specifying the requested processor. The monitor routine 
STEP checks to see if this user has any processor restrictions. 
If the user is not restricted from using the requested pro- 
cessor, STEP checks to see if the processor is a shared pro- 
cessor. If it is shared, STEP checks to see if the processor 
is in core. If it isn't in core, STEP loads it into core. If 
the processor is not shared, STEP searches the :SYS account 
and loads the processor from there. If the processor cannot 
be found, an error message is sent to the terminal. Before 
control passes to the processor, TEL checks the parameters of 
the processor call for correct syntax and for existence of the 
"sp" file and a "rom" or "list". 
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TEL sets end resets bits in JIT to correspond to the commands 
LIST, DONT LIST, etc., and to the initial occurrence of 
assignments in the command string. One JIT word (J:OPT) 
contains a bit for each option that can be specified for a 
processor. The options and their corresponding bit assign- 
ments are as follows:. 



Identifier 


Bit 


Set 


Reset 


LO 


31 


LIST 


DONT LIST 


GO 


24 


OUTPST 


DQNT OUTPUT 


DO 


23 


COMMENT 


OONT COMME 


- 


15 


DEBUG 


DONT DEBUG 


— 





ECHO 


DONT ECHO 



The underlined values are default values. The default 
setting for J:OPT is STDOPT in the monitor root (module 
LITERALS). This cell may be patched by the installation to 
generate different defaults than are indicated in the pre- 
ceding table. If a SET command is issued for the M:LO, 
M:GO, or M:DO DCB, or the list output or binary output 
fields are specified in a TEL command, the corresponding 
bits are set. Each processor must assign meaning to the bits 
in J:OPT and interpret them. Unassigned bits are available 
for future use. Checks of these bits should be made on each 
write command since TEL allows on-line users to interrupt 
the processor and turn on or off the LO, GO, and DO 
devices. 

Each processor should establish conventions to maintain 
orderly output when two or more DCBs are connected to the 
same device. The usual convention is that if diagnostic 
output has been written via M:LO, and M:LO and M:DO 
are connected to the same device, then the diagnostic out- 
put should not be written via M:DO. The following ex- 
ample illustrates some of the special cases that processors 
should consider: 

1. M:SI, M:DO, M:LO connected to the same device • 
(the input line should not appear three times). 

2. M:DO connected to a device that is different from SI 
and LO (the diagnostic comment should probably be 
printed beneath the line in error). 

3. M:SI and M:DO connected to a Teletype (processors 
may or may not want to type a line in error). 

Processors may read each input image via the M:SI DCB. 
The last record of the sp will cause an end-of-data abnor- 
mal condition (see the CP-V/BP Reference Manual, 90 17 04 
for a description of abnormal conditions). To obtain con- 
trol of an error or abnormal condition, a processor must 
issue the M:SETDCB command and/or include error and ab- 
normal exits in its read and write CALs. Since source input 
may come from a Teletype (sp = ME), processors must be 
able to handle Teletype input. The problems associated 
with Teletype I/O are discussed in the section on terminal 
I/O. 



CCISCAN 

On transferring control to a user's program or to a processor, 
the monitor communicates the TCB address via general reg- 
ister 0. Processors may fetch the card image of the command 
that called them by reading through a DCB connected to the 
C device. 

When running in batch mode, the processor must read the 
C device once to clear, *the control command. The com- 
mand is transferred fo the user's buffer to allow the user's 
program to examine parameters. 



TERMINAL I/O 

An on-line user may direct output to his Teletype at any 
time during execution of a processor. Similarly, portions 
of the input to a processor may come from a Teletype. In 
general, Teletype I/O is the same as other I/O in its use 
of MrREAD and M:WRITE operators and the standard abnor- 
mal and error situations. However, Teletype I/O has some 
features that are significantly different from those for other 
devices. Some of the differences require special attention 
by processors, but the interface is designed in such a way 
that processors will not have to know whether or not I/O 
operations are via Teletype, providing they observe certain 
conventions. On terminal I/O, like all I/O, the user 
should note that byte displacements in the DCB remain in 
effect until replaced, once they have been given. The 
special problems associated with Teletype J/0 are outlined 
in the following paragraphs. 

END CHARACTERS 

On input from a Teletype, each record read is terminated 
by an end character (CR, FF, LF, RS, US, FS, GS). The 
end character, if any, is included in the actual record 
size (ARS) count reported in the DCB (bits 0-14 or word 4). 
Each processor must interpret the different end characters. 
Processors do not have to know that input is via Teletype, 
provided they treat these characters as terminators and use 
ARS to determine the actual record received. 

Source files for all processors, including those in batch 
operations, may have been prepared on-line. Since records 
prepared on-line are variable length, it may no longer be 
assumed that input records are 80-byte card images. 

AJI characters received from terminals, no matter of what 
type, are translated to the standard EBCDIC character set. 
The hexadecimal codes for EBCDIC characters are listed 
in Appendix H . 

WRITE OUTPUT 

The length of each output line is specified by the SIZE 
parameter in the M.-WRITE procedure call. It is terminated 
only by the character zero. That is, the user may term- 
inate a message with a zero character if he wishes and 
the COC routines will compute the proper message length. 
Carriage return or new line characters do not terminate 
a message. 
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CARRIAGE RETURN 



OTHER ABNORMAL CONDITIONS 



A new line or carriage return sequence, as appropriate to 
the type of terminal, is appended to the character string 
supplied by each write under the following circumstances: 

1. The DCBis not M:UC. 



If unknown operations are requested of the COC routines 
(e.g., write end-of-file), the abnormal code for beginning- 
of-tapeVill be returned. If there is no abnormal address, 
the operation will be ignored. 



2. The suppress space option is not specified* 



Thus, under ordinary circumstances, carriage return char- 
acters will be supplied when output consists of one line per 
write and the DCB is connected to a terminal. By using the 
suppress space option or by writing through M:UC, the pro- 
gram may supply carriage returns exactly to requirements — 
either none or several for each write CAL. 



PARITY ERRORS AND LOST DATA 

When an M:READ CAL specifies a terminal, any character 
received with a parity error is replaced bySUB(USASCII 
code 1A) and the lost data abnormal code (07) is returned 
to the user if an abnormal address exists. If there is no 
abnormal address, control proceeds to the CAL plus 1. 
The line is returned to the user's buffer and the program 
may expect to encounter the SUB code as it scans. 



In designing a response to messages that contain parity error 
characters, two facts are important: 

1. The user has already been informed of the error by the 
COC routines that echo the exact bits received on the 
line followed by the ' character. 

2. If the received image is sent back to the terminal to- 
gether with an error message, the * character will be 
printed when SUB codes appear. 



In the absence of special considerations unique to the pro- 
cessor, it is recommended that lines received with lost data 
be sent back to the terminal together with the comment 
"EH?". This procedure is helpful as an aid in diagnosing 
faulty terminals and communication lines. 



END-OF-FILE 

If the user types the character pair ESC F, an end-of-file 
abnormal code will be returned to the program reading the 
terminal at the abnormal address (if there is one). An input 
line that contains all characters received prior to the end- 
of-file sequence will also be transmitted to the user's buf- 
fer. This line is always terminated with a carriage return 
which is also sent to the user's terminal. If no abnormal 
address is specified, the line appears as an ordinary input 
line. If both bad data and end-of-file occur in the same 
input, then the bad data is reported. 



FORMAT CONTROL 

COC routine action for the^various formatting CALs is 
specified in the CP-V/TS Reference Manual, 90 09 07. It 
is briefly reviewed below. 

It is sometimes necessary to print a line with special spacing 
or without a carriage return. Processors can obtain verti- 
cal carriage control by means of two parameters (SPACE 
and VFC), both of which can be set by the DEVICE CAL. 
The SPACE and VFC parameters have the following inter- 
pretations for Teletypes. 



Parameter Meaning 



SPACE 



VFC 



If this parameter is set and VFC is not on, the 
number of spaces indicated minus 1 is in- 
serted before each write. Counts of and 1 
result in single spacing. 

If this flag is set, the COC routines simulate 
the printer's vertical format control as speci- 
fied in the first character of the text lines 
written. The simulation is limited to one of 
the following cases: 



Hex. Code 



Cl-CF 



Fl 



60,E0 



Action 

COC inserts 1-15 spaces be- 
fore printing. 

COC skips to top-of-page by 
skipping six lines and printing 
the heading information fol- 
lowed by the print line. 

COC does not insert CRLF 
after the print line (suppress 
space). 



For page control, COC routines count the number of lines 
transmitted to and received from the user's terminal. New 
page headings are printed for every read or write when the 
line count exceeds the maximum specified in JIT (via the 
PLATEN command). New page headings are also printed if 
the user program issues a PAGE device CAL or if the termi- 
nal user types the FF character L c (CONTROL L). 

Information in the page heading may be specified by the 
user by means of the HEADER and COUNT device CALs. 
Heading information is taken from the DCB through which 
the read or write was given. Thus, if a write call is issued 
to a Teletype through more than one DCB, the heading 
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printed depends upon the DCB through which the top line of 
the page was written. The automatic page heading occupies 
one line and contains current time, date, user name and 
account number, user identification and line number, page 
number, and possibly an administrative message. Readings 
specified in the DCB df the read or write are produced after 
the automatic heading with position, text, and page number, 
as specified in the CP-V/BP Reference Manual, 90 \7 64. 
The page count in this heading is that carried in the DCB 
and is reset with each COUNT device CAL. The page count 
for the automatic heading is carried in JIT and may be reset 
via the TEL PAGE command. The automatic heading is sup- 
pressed if the page length is less than eleven lines. Head- 
ings are also not printed if the automatic page heading is 
turned off via the TEL PLATEN command. 

Tab characters are replaced with an appropriate number of 
blanks in input lines. Tabs are not required in output lines. 
However, if a highly formatted output line is sent to the 
Teletype, the operation will be more efficient — and more 
satisfactory for the on-line user. Tabs are activated by in- 
serting a tab character (X'05')in the outputstream. Tabs may 
be sent directly to the terminal or simulated by the software 
as requested by the terminal user who may turn simulation 
on and off using the sequence © T. When simulated by the 
software, each tab character in the output stream causes 
insertion of spaces to move the carrier to the right of the 
next higher position specified in the DCB. 

Simulated tab stops can be set by a processor with the TAB 
device CAL or by an on-line user (for the M:UC DCB) with 
the TABS command. Tabs must be specified in ascending 
order beginning with tap stop position 1. Note that this is 
different from the line printer tabbing, where the tabs need 
not be in ascending sequence. Tab stops can be set at any 
time for any DCB. During output operations, tabs are 
expanded as specified by the DCB through which the write is 
issued or, if not specified there, as specified in the M:UC 
DCB. Tabs typed by an on-line user are simulated at the user's 
console according to the tab settings in the M:UC DCB. 

If the backspace character is typed at the terminal, the 
character is passed to the reading program. No special 
action is taken by the COC routines other than that neces- 
sary to record current carrier position (which for backspace 
depends on terminal type). Terminals that have a physical 
backspace may, at the user's option, use a "backspace-edit" 
mode for intra-line editing. (Reference: CP-V/TS Reference 
Manual, 90 09 07.) 

A program can request control when the user presses the 
BREAK key by means of the M:INT procedure. Whenever 
the user presses the BREAK key, the program environment at 
the time of the break is recorded in the user's pushdown stack 
in his TCB. Execution can be returned to the location fol- 
lowing the interrupted instruction by execution of the M:TRTN 
procedure. A program can return break control to TEL by 
executing the M:INT procedure with a break routine address 
of zero. The break routine address is checked by the monitor 
to guarantee that the address lies within the memory allo- 
cated to the user. Even if a processor has obtained break 
control, an on-line user can return execution control to TEL 
by pressing the © © , © Y, or Y keys. 



As a safety measure to protect the user against faulty pro- 
gramming in break control routines, the number of times the 
BREAK key is pressed by a user without intervening charr 
ccters is recorded. When the count, reaches four, control 
is sent tc> TEL as if Y° had been pressed. Thus, the user at 
the terminal will, never find himself locked out. The count 
'of four gI lows processors (e.g., FDP) to make special inter- 
pretations on two arid three breaks in, a row. 



FILE EXTESSrOW 

File extension is a convention by which records are added 
to an output file by successive job steps. Each time the file 
is opened, the file pointer (tape, disk pack, etc.) is posi- 
tioned to a point immediately following the last record in 
the file. Thus, when additional output is produced it is 
added to the previous contents of the file, thereby extend- 
ing it. File extension simulates output to physical devices, 
such as line printers or typewriters, when output is actually 
directed to a file. 

File extension takes effect at the time CP-V opens system 
output DCBs. The output DCBs that are affected by file 
extension are those that are currently assigned to files, al- 
though normally assigned to devices. They include: M:LO, 
LL, DO, PO, BO, SL, SO, CO, AL, EO, and GO. 



File extension is discontinued when a file is reassigned 
with a SET or ASSIGN command or when a file is opened 
with an OPEN procedure call that specifies an explicit 
file name. In these cases, a new file is created. Exten- 
sion of the GO file is terminated following a LINK, LYNX, 
or RUN command. 



SHARED FILE USE 

Shared processors must ensure that temporary files used 
during operation are distinct for each instance of exe- 
cution. A common technique for accomplishing this is 
to append the current users ID, from the right half of the 
first word of JIT, to the filename when it is created and 
used. This ID is guaranteed by the system to be unique 
for all concurrently running batch or on-line programs. 
A discussion of shared files is contained in CP-V/BP Ref- 
erence Manual, 90 17 64. 



COMMAND PROCESSOR PROGRAMMING 

A command processor is a shared processor which inter- 
faces between the user and that which the user wants to 
access — the monitor, a processor, or another program. 
Four command processors are supplied with CP-V. They 
are LOGON, TEL, CCI, and EASY. CP-V will also 
support installation-specific command processors. Infor- 
mation about the programming of command processors is 
outlined below. 
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Generally, command processors have the same restrictions 
as listed for shared processors previously. In addition: 

1. A command processor may not have any overlay 
structure. ; 

'-.•'•■ . • ■ ' • ? • ' 

2. A command processor which resides iji the special pro- 
cessor area (above X' 1C000 1 ) may not have any dynamic 
data and must be biased at X' 1C400'. 

3. A command processor must intercept all exits, errors, 
and aborts from user programs and must clean up cor- 
rectly. (Special CALs for command processors are 

I isted below. ) 

4. Command processors should not be given special JIT 
access. (The special CALs for command processor in- 
terface eliminate the need for it.) 

5. When programs error or abort, control will be given to 
the command processor with the following restrictions: 

If the command processor resides in the user 
program area (X'AOOO' to X'lC000')or the user 
program is loaded in the extended mode (X'AOOO 1 - 
X' 1FFFF')/ the exiting user program will be com- 
pletely disassociated before associating the com- 
mand processor, eliminating the possibility of 
continuation of the |ob step. 

If the command processor resides in the special 
area (X' 1 C600' to X' 1 FFFF* ), has no dynamic data 
or DCBs, uses only M:UC and M:XX, control will 
pass to the command processor with the user intact, 
allowing analysis of the exit and continuation of 
the current job step. 

Command processors maybe entered into the system during 
PASS2 of SYSGEN by using the T, B, G, and C flags of 
the :SPROCS command. They may also be added to the 
system, replaced, or deleted from the system via the DRSP 
processor. 

The following capabilities are available to command 
processors: 

1. Interpretive Exit — An interpretive exit is a natural 
exit CAL (M:EXIT) performed by a command processor 
with the following register setup required. 

R6, R7 Contain the TEXTC name of the requested 

R8 load module or shared processor. A maxi- 

mum of seven bytes is allowed for a shared 
processor. If R6 is zero and the command 
processor is special shared, (biased at 
X' 1C400'), the program is reentered at the 
point of interruption. 

R13, R14 Contain the account (in TEXT format) in 
which the load module resides. :SYS is 
specified for shared processors. 

RIO, Rl 1 Contain the password in TEXT format. If 
there is no password, zero should be used. 



R0,R1 Contain either F.DP orJDELTA in TEXTC 

format or a zero. If one of the two debug- 
gers is specified, the interpretive exit is to 
b& taken w}rh the debugger associated. 

'"•.■■■'•■.. ; *. 

The system job- step processor, STEP, interprets such an 

exiles acqJKon the specified program. It also loads 

the TEXTC name of the command processor that issued 

•the interpretive exit into R4and R5. Before a com- 

rnand processor issues an interpretive exit, it must have 

closed all its DCBs and, in general, have cleaned up. 

The job step processor arbitrarily removes the command 
processor from the user's virtual map. This means that 
all data and DCBs are gone. 



2. BREAK and CONTROL Y Control - If the terminal user 
depresses the BREAK key during operation of a pro- 
cessor or user program and that program did not request 
BREAK control, the program is aborted and the com- 
mand processor is loaded and entered with bit 30 of 
J.-TELFLGS in the JIT set. If the interrupted program 
has requested BRE^K control, the program's BREAK rou- 
tine is entered. 



If the terminal user depresses CONTROL Y during the 
execution of a processor or user program and the com- 
mand processor is not special shared, the program is 
aborted and the command processor is loaded and en- 
tered. If the command processor is special shared and 
has no data and no DCBs, the user program is left as is 
and the command processor is entered. This gives the 
command processor the opportunity to continue the 
interrupted program. 



If the terminal user depresses CONTROL Y while a 
command processor is in control, the event is ignored 
and the current operation is continued where it was 
interrupted. 



If the terminal user depresses BREAK while a command 
processor is in control and BREAK control has not been 
requested or BREAK control has been reset via the 
M:INT CAL, the BREAK event isignoredand the com- 
mand processor is continued where it was interrupted. 
If a command processor has requested BREAK control, 
it is interrupted at its BREAK control address. 



The format of the BREAK control CAL is: 

CALI,8 FPT 
where FPT points to word of the FPT shown below. 

Word 



X'OE' 



6 123145 67 











BREAK routine address 



8 9 10 111 12 13 14 151 16 17 18 19120 21 22 23124 25 26 27(28 29 30 31 
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If the CP bit is set, the BREAK control routine of the 
interrupted program Is reestablished. This allows a user to 
depress CONTROL Y while in a program with BREAK con-, 
trol, enter his special shared command processor which 
remembers the old BREAK control address, and then estab- 
lish BREAK control fo^the command processor. If the user 
wishes to continue, the command processor, may set. the 
CP bit and execute the BREAK control CAL before exiting 
back to the user's program. The BREAK routine addre«s in 
this case should be the one that was active when the com- 
mand processor was first entered as a result of CONTROL Y. 

3. Exit, Error, Abort CAL, and I/O Abort Control — If any 
exit or abort condition occurs during execution of a 
program, the program is aborted and the command pro- 
cessor is loaded and entered. Error conditions are de- 
scribed in four fields of the JIT as follows: 

• J:ABC is the address of the word in the JIT that 
contains the abort code in byte 0(see Appendix B 
of the CP-YyT$ Reference Manual, 90 09 07). 

• ERO is the word offset into the JIT of the word 
that contains the abort subcode in byte 3. 

• J:RNST is the address of the word in the JIT that 
contains the current run status. Status settings are: 

All 

zeros means the job is executing normally. 

Bit 1 if set, the job is to be errored because of 
an M:ERR call to the monitor. 

Bit 2 If set, the job is to be aborted because of 
an M:XXX call to the monitor. 

Bit 3 if set, the job is to be errored because of 
an E key- in by the operator. 

Bit 4 if set, the Job is to be aborted because of 
an X key-in or a I ine disconnect. 

Bit 5 is reserved for future use. 

Bit 6 if set, the job is to be aborted because a 
limit has been exceeded (e.g., maximum 
pages out). 

Bit 7 if set, the job is to be aborted because of 
an error (most likely I/O) as specified in 
JrABC and ERO. 

Bit 8 if set, the job is to be aborted because of 
an illegal trap. 

• J:ASSIGN contains the address of the word in the 
JIT, the rightmost nine bits of which indicate which 
limit was exceeded. This field is set in conjunction 
with bit 6 in the RNST field of the JIT. The bits, 
if set, mean: 

Bit 23 the maximum disk allocation limit 
exceeded. 

Bit 24 the maximum time limit exceeded. 



Bit 25 the maximum scratch tape limit 

exceeded. 

Bit 26 the maximum temporary disk space 

limit exceeded. *' 

Bit 27.. - the, maximum permanent disk space 
limit exceeded. 

Bit 28 the maximum diagnostic pages output 

limit exceeded. 

Bit 29 the maximum user pages output limit 

exceeded. 

Bit 30 the maximum processor pages output 
limit exceeded. 

Bit 31 the maximum punch output limit 

exceeded . 

4. CAL Control of JIT Error Condition — This CAL al lows 
control of JIT error conditions without special JIT ac- 
cess. The form of the CAL is: 

CAL 1,4 fpt 

where fpt points to the word shown below. 



X'06' 



1 2 al« 5 6 7 la 9 10 III 12 13 14 is! 16 17 18 l»l» 21 22 Zi\u 25 26 T?\ 28 29 30 31 

The monitor (the ALTCP portion) verifies that the pro- 
gram issuing the request is a command processor through 
use of UH:FLG. It then sets J:ABC, ERO, byte of 
J:RNST, and bit 30 of J:TELFLGS to zero. (Bit 30 of 
J:TELFLGS indicates whether or not the BREAK key has 
been depressed.) If the program issuing the CAL is not 
a command processor, control is returned to the user 
program with CC1 set. 

5. Registers — Upon entry to a shared processor from a 
command processor, the registers must contain the 
following: 



R0 



the TCB, address of the user program. 



R4, R5 the name of the calling command processor 

in TEXTC format. 

R6, R7, the name of the called processor in TEXTC 
R8 format. 

R10,R1I the password in TEXT format (zero if none). 

RI3, R14 the account of the called processor in TEXT 
format. 

6. CAL Control of Terminal Modes — Control of terminal 
modes is provided by a variation of the Change Ter- 
minal Type CAL (see the CP-V/TS Reference Man- 
ual, 90 09 07). 
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PUBLIC LIBRARIES 

The system may have several shared public libraries. Each 
library is a unit tailored to the requirements of the installa- 
tion. The user associates a public library with his program 
by specifying the library name (Pi where i -0-9, JO, or J t) 
in a LINK or RUN command. The rule governing library 
units are as follows: 

1. Link loads the usefj data immediately above the area 
reserved for the library-data. Load reserves an entire 
page for library data. 

2. No initialization is provided for this temporary library 
data either by the loader or by the system. There must 
be an initialization program if initialization is required. 

3. Each library unit must separate data (CSECTO) and pro- 
gram (CSECT1) information into separate assemblies so 
that separate ROMs will be produced for each. 

4. All code must be under CSECTs with protection type 
for variable data or 1 for procedure and constant data. 
No DSECT section may be used. 

5. The library must be self-contained (i.e., there can be 
no unsatisfied references). This must be true for the 
data portion itself and the total library. For example, 
a FORTRAN I/O library must search the DCB chain 
rather than make a direct reference to the DCB itself. 



Public library :PI contains single. and double precision trig- 
onometric functions, exponential and logarithmic functions, 
standard ser-up routines, initialization and termination rou- 
tines,, and input/outputconversion and transmission routines. 
Fewer 9 than 1000 words of storage are required for temporary 
storage by each user of the library. Over 5100 words of li- 
brary code are shared among all concurrent users. 

FDP users require public library :P0 which consists of nearly 
1400 words of temporary storage per user; over 10,000 words 
of code are shared among the concurrent users. 

Real-time users require public library :P4 which consists of 
fewer than 1000 words of temporary storage peruser; over 
5300 words of code are shared among the concurrent users. 

The remaining routines (approximately 190) of the complete 
FORTRAN library are organized in two ways: 

1 . They are organized in the :BLIB file as card-image ROM 
decks that are used by the Link loader to satisfy library 
references. ~ - 

2. They are organized in the :LIB/:DIC files as 22 library 
load modules. 

This organization permits rapid loading by the overlay loader 
or Load. The overlay loader uses the file :DIC, which con- 
sists of a record keyed by each DEF in :LIB and the group 
number as its value to find the LM names necessary to satisfy 
references. 



CP-V PUBLIC LIBRARIES 

Six public libraries are available to the system programmer. 
One library (:P1) includes the most commonly required rou- 
tines from the Extended FORTRAN IV library (about 65 rou- 
tines). Another (:P0) includes :P1 plus the FORTRAN Debug 
Package (FDP). A third (:P4) includes :P1 plus the FORTRAN 
real-time features. The fourth library (:J0) contains the JIT 
definition. Most executing users need only the first library; 
users who are debugging need the second; real-time users 
need the third. The fifth library (:J1) contains the monitor 
(M:MON) definitions and is useful only to programs which 
interface directly with monitor tables and routines. The 
sixth library (:J2) is actually a subset of :J1. It contains 
the definitions for the LITERALS module of the monitor and 
is useful primarily to programs that wish to access the moni- 
tor's extensive literal and constant pool in order to avoid 
duplicating these items. (All programs have read access 
to the LITERALS module.) 

The entire Extended FORTRAN IV I ibrary consists of 252 rou- 
tines (ROMs) totaling more then ten thousand instructions 
and over 800 data words . 



The package includes more than 350 DEFs. These routines 
are described in Extended FORTRAN IV Library Technical 
Manual, 90 15 24, and Sigma 5/7 Mathematical Routines 
Technical Manual, 90 09 06. 



Real-time versions of :BLIB, :LIB, and :DIC must be main- 
tained in the real-time system account (e.g., :SYSRT). 

One essential monitor subroutine must be added to the stan- 
dard released library, S:OVRL. It is normally added during 
the System Generation process but must be remembered when- 
ever a new library is being installed. 

The size and description of routines in :LIB are given in 
Table 40. 



i CREATING PUBLIC LIBRARIES 

Users may add their own public libraries to meet specific 
requirements. The necessary procedures are given below. 

The procedure for creating public libraries consists of several 
steps. The desired data and program elements are loaded, 
and the dictionary for the library (DEFs) is filed for loader 
use. Next, the procedure is filed so that SYSMAK can place 
it on swap storage during system initialization. In the 
process, the program SYMCON is used to retain only those 
DEFs required in the final linking process, thus saving loader 
stack search time. Figure 13 illustrates the process of creat- 
ing a public library. 
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Table 40. 


Routines in :LIB Library File 


Group 


Size 


Description *. . 


1 


96 


Complex double precision mathe- 
. mqtical routine drivers. 


2 


72 


Corriplex mathematical routine 
drivers. 


3 


92 


Double precision mathematical 
routine drivers. 


4 


86 


Single precision mathematical 
routine drivers. 


5 


277 


External revisions of compiler 
intrinsic functions. 


6 


618 


Complex double precision mathe- 
matical routines. 


7 


538 


Complex single precision mathe- 
matical routines. 


8 


74 


Double precision mathematical 
routines: 


9 


104 


Miscellaneous integer functions. 



Table 40. Routines in :LIB Library File (cont.) 



Group 


Size 


— i ■ ■■ ■ — 
Description 


10 ';■ . 


76 


. Miscellaneous real functions. 


11 


78 


Log red! functions. 


12 


18 


Conversion routines. , 


13 


362 


DSI NH, DTANH, ,DASIN> 1 
DTAN. 


14 


308 


Miscellaneous nonnumeric functions. 


15 


20 


Overflow and divide check. 


16 


508 


Nonstandard and asynchronous I/O. 


17 


750 


Input and INPUTL. 


18 


160 


Random access. 


19 


514 


Disk buffer. 


20 


102 


Keyed file I/O. 


21 


836 


Name list I/O. 


22 


938 


Defined file I/O. 
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Figure 13. Public Library Creation Process 
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j .laAMKC-ptftfts libraries ; 

Default loading for Link includes, the basic FORTRAN public 
library (:P1) and a search of the system (ROM) library if 
there are unsatisfied references. This is the same as if the 
user had specified (:P1) in- a RUN or* LINK command. If the 
user haf hot explicitly asked for :P1 and no reference to 
9INITIAL is- found , the procedure for : PI is not associated 
with the user program execution a! though. the 90.0 data words 
remain committed because of the single pass loader oper- 
ation. Figure 14 is a generalized flow of the LINK process 
relative to libraries. 

Since the overlay loader operates in two passes, it makes 
an explicit association of :P0 and :P1 to a program in 
absence of other instructions. This process is illustrated in 
Figure 15. 

Real-time users must specify public library :P4 and the real- 
time version of the system library. This means that the Link 
processor requires specification of P4 and inclusion of file 
:BLIB in the real-time system account (e.g., :SYSRT) as a 
library file identification. It also means that the overlay 
loader requires specification of :P4and the real-time system 
account in the library account list. 



SHARED PROCESSOR MAiHTEHANCE j(0RSP) 

Development and check out of CP-V systems is simplified 
through use of DRSP (Dynamic Replacement of Shared Pro- 
cessors). DRSP allows replacement, creation, or deletion 
of shared processors while the system is operational. The 
extra processor space in the shared processor tables must be 
allocated during system generation (PASS2). Processors 
that are normally invoked following a recovery cycle 
(ALLOCAT, GHOST 1, RECOVERY, and XDELTA) are not 
dynamically replaceable. DRSP must be run as a shared 
processor in order to maintain integrity of the monitor's 
processor tables. 



Note: XDELTA (Executive Delta) is an additional debug- 
ging aid that is optionally retained at system ini- 
tialization. XDELTA is described in the Delta 
chapter of the CP-VAS Reference Manual, 900907. 



DRSP can be run either as an on-line or a batch processor. 
Input can be either from the command device or from a 
terminal. DRSP is called on-line by entering the name of 
the processor as a TEL command. 



Example: 

JDRSP© 
DRSP HERE 



TheDCBs used by DRSP which maybe assignedby the user are: 

1. M:SI for command language input. 

2. M:LL for terminal output. 

3. M:SL for listing of input commands during a batch run 
and diagnostic message output. 

DRSP COMMANDS 

The seven DRSP commands are 

ENTER 

REPLACE 

DELETE 

LIST 

LISTALL 

? 

END 

In the DRSP command descriptions, the term 'proname' refers 
to the name of a processor as found in the shared processor 
tables. The file specified by proname must be in load module 
format. 

All of the above commands except " ?" can be followed 
by comments, which will be printed as part of the com- 
mand line during a batch run of DRSP. To add comments, 
terminate the command with a blank character followed 
by a period. All characters entered after the period are 
treated as comments. The comments are terminated by © 
or end-of-card. Comments cannot be continued to the 
next record. 

ENTER The ENTER command is used to enter a new 

shared processor into the system. 

The format of the command is 

E[NTER] proname [{wn^'^k 01 *' "] D°P tion ] D°P tion ] 

where the options are as follows: 

[J][S][D][P] [M][X][T][B][G][C] specifies one or more 
flags to be associated with the processor. The 
flags indicate the following. 

J processor is allowed to alter the JIT. 

S special shared processor. 

D processor is a debugger. 

P public library. 
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Error Message: 
Compiler for debug 
and library not 
associated* 



( Done J 



Read and 'Load 
Specified ROMs. 



Flag DCB REFs 
to be built later. 




GED 



Search for library 
fi les and load 
those found. 




Open and 
search :BLIB 



( Done ) 



Figure 14. Generalized Library Load Process (Link) 
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f Done ) 



PUBLIC 
LIB 



Process ROMs or LMs 
from homed files and/or j 
from BI esr GO. 




no 



Determine which :Pn 
(either :P0 or PI). 



PUBLIC 
LIB 



Initialize UNSAT list. 




Get next UNSAT entry. 




no more 
entries 



Satisfy remaining REFs 
from :LIB in this account. 




no 



f Done ) 



Determine which :Pn 
(either :P0 or :PI). 



PUBLIC 
LIB 



( Done J 




Get the requested 
:Pn (from :SYS) and 
associate it with the 
load module being 
built. 



f Return J 



Note; If NOSYSLIBis presenton the ILOAD card, the UNSATlist is empty or consists of those sources (accounts and/or :Pn) 
mentioned under the UNSAT option. If NOSYSLIBis not present, the UNSATlist consists of the above plus the :SYS 
account (which occurs last). For LYNX, the NL option has an identical effect upon the library account list. 



Figure 15. Generalized Library Load Process (Overlay Loader) 
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■•> M processor allowed maximum memory during 
execution. 

X piocessoral lowed to execute the M:SYS CAL. 

T command processor accessible by terminal 

users. 

B command processor accessible by batch 
users. 

G command processor accessible by ghost users. 

C command processor accessible by terminal, 
batch, and ghost users. 

If Dor Pis specified, S is redundantand is assumed. 
If the C flag is used, the specific flags (T, B, G) 
are redundant and should not be used. Various 
combinations of the above are possible up to a 
maximum of six characters; e.g., a processor that 
is allowed to alter the JIT and has maximum mem- 
ory available for execution would be flagged JM. 
The flag combination PD or usage of the P flag 
when the processor name is other than :Pnn results 
in an error message. 

fERM specifies that the processor is to be available 
;to users even after a system crash. The processor 
*w?ll be present both in the system account (:SYS) 
diid.ari swap disk. "Empty" slots must be avail- 
able in the disk copy of the processor tables. If 
this option is not used, the new processor version 
will reside only on swap disk and will be lost in 
the event of a crash. The version of the processor 
that will be restored is the version in the system 
account at the time of the crash. 

W specifies that if the proname cannot be entered 
into the processor table because there are no name 
slots free, DRSP is to wait until there is a slot 
available. If this wait option is not specified, 
the command terminates without entering the 
new processor. 



REPLACE The REPLACE command is used to replace an 
existing shared processor. If this command is used, the 
previous version of the processor is lost. However, cur- 
rent users continue to use the old copy until they are 
disassociated from the processor. 

The format of the command is 



PERM specifies tnat.fche, ? ; new v version of the pro- 
cessor is to be available to users "e'v"e'ri-^rftef-,<£ s^s.-- 
tern crash. This version of the processor will be 
present both in the system account (:SYS) and on 
swap disk. "Empty" slots must be available in 
the disk copy of the processor tables. If this 
option is not used, the. new, processor version will 
reside only on swap disk and will be overwritten 
in event of a crash by the processor version in the 
system account. 

W specifies that if the proname cannot be entered 
into the processor table because there are no name 
slots free, DRSP is to wait until there is a slot 
available. If this wait option is not specified, 
the command terminates without replacing the old 
processor. 



DELETE The DELETE command prevents further user 
association with a processor. Users associated with the pro- 
cessor when this command is issued will continue to use the 
processor until they disassociate. 

The format of the command is 

D[ELET E] proname [, PERM] 

where PERM specifies that no new users will ever be asso- 
ciated with this processor (even after a system crash). 

LIST The LIST command lists the processor name, the 
name associated with each entry in the processor name table, 
and the amount of disk space occupied by the processor. 

The format of the command is 



LOST] 
where 



[pronamelj 
#xx[-yy]|J 



proname specifies an explicit processor name. (The 
proname MrDUMLM appears many times in the pro- 
cessor tables. If selected, all these entries will 
be listed. ) 

xx-[yy] specifies the name table index or a range 

of name table indexes to be listed. 

Initial use of the LIST command with no proname or index 
specified will provide a list of each processor table entry 
and its corresponding table index. 



RpEPLACE] proname | W | TH I fid [/>ption][/>ption] [/option] 



where the options are as fol lows: 

[J][S][D][P][M][X][T][B][G][C] specifies flags to be 
associated with the processor. The option is the 
same as for the ENTER command. 



LISTALL The LISTALL command lists each shared pro- 

cessor name and its entries in the following tables: 

PB:HPP Head of the physical page chain. 

PB:TPP Tail of the physical page chain. 

PB:DSZ Number of data pages. 
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PB:DC3S2 Number of DCB pages. 

PH. PDA Disk address of ftrsf 'procedure page. 

'. • '« 

PH:DDA Disk address of first page of data and DCBs. ^. 

...'•.-•' . '■•.'. ■•->'.' ' • - * 

P&:'UC Number of users i n core usinq the processor. ; '*, - 

.•'■■-' ' • . - - r ■ «*v 

PB:LNK / Processor number of next overlay. 
PB:PVA Virtual page niimber of first procedure page. 

PB:HVA Virtual page number of first unused page. 

P:SA Processor flags and start address. 

The format of the command is 

LISTALLr(P r T me ) 
_l*xx[-yyj 

where proname and xx[-yy] are as defined in the LIST 
command. 

? The question mark command requests a detailed error 

message when an error has been noted by DRSP. The com- 
mand is applicable only for the on-line mode. Its function 
is described indetail in the section "DRSP Error Messages". 
The format of the command is 



END i The END command terminates DRSP. The format 
of the command is 

END 

DRSP LIMITATIONS AND RESTRICTIONS ' 

The following lists DRSP limitations and restrictions: 

1. Only users with a privilege level of CO or greater are 
allowed to use the ENTER, REPLACE and DELETE com- 
mands. The LIST command requires a privilege level 
of 80 or greater. 

2. There must be sufficient space in the swap disk 
processor/overlay area to hold the new or replacing 
entry. This extra space is allocated by SYSGEN 
PASS2 via a rSPROCS control card. 

3. Replaced or entered items must be accessible load 
modules. 

4. Only one level of overlay is permitted in a processor. 

5. A processor overlay must be PROCEDURE only. 

6. ALLOCAT, GHOST1, RECOVER, XDELTA, MrDUMLM 
may not be processed with DRSP commands. 



7. Overlays" Ear processors cannot be replaced or entered 

individuaily. 

8. GETs of programs saved with an associated processor 
most like!/ will not work if the processor has been 
changed between SAVE and GET. 

9. When replacing the FILL processor a modified proce- 
dure is required: Following REPLACE FILL WITH 

N. A. P. , OPTION I thru 3, the user has to abort the 
FILL ghost. This is done via a message to the operator 
to key in X, id, where id is the SYSID of the FILL 
ghost which appears when the message 'REQUEST FILL, 
NO FILL, OR INSTANT SQUIRREL (F, N, S)' is output 
on operator's console. This will ensure that the FILL 
copy in the user swap disk area is destroyed and the 
replaced version of FILL is brought in the next time 
FILL wakes up. 



i DRSP ERROR MESSAGES 

The error message structure of DRSP is designed to give a 
user detailed information when so desired without burdening 
him with long typeouts when the error is obvious. When 
running on-line, DRSP will respond to commands in error 
by typing 

EH@n 

where n is the character position at which an error was first 
detected. If the user requires more information, he responds 
with a question mark (?). DRSP responds with a detailed 
error message (see Table 41). If the error is obvious, the 
user may retype the command (or proceed to the next com- 
mand). For errors that occur after command syntax is com- 
pleted, this message changes to 



EH 



since command character position is meaningless. 

In batch mode, the detailed error messages are printed with- 
out the interrogative sequence described above. 

In addition to error messages, certain other messages are 
given for information purposes only (see Table 42). No re- 
sponse is expected. 

Except where noted, the error condition truncates execution 
of the requested command. 



DRSP COMMAND SUMMARY 

Table 43 contains a summary of commands for the DRSP 
processor. The left-hand column specifies the format and 
the right-hand column defines the function. 
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Table 41. DRSP Error Messages 


Message 


Meaning 1 


BREAK 50^ 
BREAK 51 
BREAK 52 
BREAK 53 


'4 ' " ' 1 

v User/nit BREAK during DRSP execution. The number defines the point or which \ 
the L|jc%P processor exited, as. described in the UTS /Reliability pn'd Maintain- j 
ability Technical Manual, 90 19 90. ' 


CANNOT OPEN THE FID 


DRSP cannot access the load module defined by the fid. 


CAN'T OPEN M:BO (PERM) 


I/O error detected while trying to open the output file in :SYS. The processor 
is entered/replaced on non-"PERM" basis. 


DON'T USE COMMAND ON 
TEl/CCI 


ENTER or DELETE commands must not specify the proname 'TEL' or 'CO 1 . 


DRSP I/O ERROR IN READING 
COMMAND 


Error detected in reading DRSP command. 


DRSP I/O ERR/ABN (CLOSE) 


Error-or abnormal condition detected at CLOSE of output file. The processor 
is entered/replaced on non-"PERM" basis. 


DRSP M : BO ERROR (PERM) 


I/O error detected while writing or closing the output file in :SYS. The 
processor is entered/replaced on non-"PERM" basis. 


DRSP M:EI ERROR (PERM) 


I/O error detected while reading file fid. The processor is entered/replaced 
on non-"PERM" basis. 


DRSP M:EI ERROR (WRITESWAP) 


I/O error detected while reading fid for writing on the swap disk. 


DRSP NOT FOUND IN 
PROCESSOR TABLES 


DRSP must be run as a shared processor in order to maintain integrity over the 
monitor's processor tables. 


DRSP PROGRAM ERROR 
(SHOULDN'T HAPPEN) 


DRSP detected contradictory conditions during processing. Requires system 
programmer intervention. 


ERR MSG NOT FOUND. 
KEY = xxxxxx 


No error message corresponds to the error code xxxxxx generated. Please 
report this system error. 


FID IS NOT A LOAD MODULE 


Error or abnormal return executed while trying to read the TREE record of the 
load module specified by fid. 


FILE STORAGE LIMIT IN 
SYSTEM ACCOUNT 


When writing the load module into the :SYS account for the PERM option, the 
file space for that account is exceeded. 


ILLEGAL COMMAND 


Command entered is not defined in DRSP. 


ILLEGAL COMMAND OPTION 


An optional parameter typed in the command is not recognized. 


ILLEGAL INDEX RANGE 


Index specified in LIST/LISTALL command not within legal range of processor 
name table. 


ILLEGAL LMN (LOAD 
BIAS CHECK) 


Illegal load bias detected when processor written to swap disk. 


ILLEGAL PRONAME, NOT 
:PNN FORMAT 


A processor flagged as a public library must conform to the name format :Pnn. 


ILLEGAL PROTECTION TYPE 
FOR PUBLIC LIBRARY 


The load module for a public library must be root only and procedure only. 
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Table 41 . DRSP Error Messages (conr. ) 



Message 


Meaning . 


INCORRECT FID - 


The fid*' specified exceeds the field maximum for name (15 characters) or 
account- (8 characters) or password. (8 ^characters). 


INSUFFICIENT MEMORY TO 
READ MAX RECORD OF FID 


DRSP has failed to acquire enough memory to read .the largest record of the 
load module specified as fid. 


INSUFFICIENT MEMORY 
TO READ TREE 


Memory space available to user is not sufficient to process the load module 
specified in the ENTER or REPLACE commands. 


INSUFFICIENT PRIVILEGE 
FOR DRSP USAGE 


The user must have a privilege level of 80 or greater to execute any DRSP 
commands. 


INSUFFICIENT PRIVILEGE 
LEVEL TO PROCESS THIS 
COMMAND 


The user does not have sufficient privilege of CO to process ENTER, REPLACE, 
and DELETE commands. 


INSUFFICIENT SPACE ON 
SWAP RAD 


The disk space allotted for new or replaced load modules is too small for the 
load module specified. 


INSUFFICIENT VIRTUAL 
MEMORY TO EXECUTE DRSP 


There are not enough virtual pages to allow DRSP to access the monitor* 


NO ERRORS 


No errors were encountered during command execution. 


NO PRONAME SLOTS AVAILABLE 


. The number of extra processor name table entries is exhausted. 


NO SUCH PROCESSOR i 


The proname entered cannot be found in the processor tables. 


ONLY ONE LEVEL OF OVERLAYS 
FOR SHARED PROCESSORS 


When analyzing the load module TREE record, more than one level of processor 
overlay was indicated. 


ONLY PROCEDURE if ALLOWED 
IN A PROCESSOR OVERLAY 


DRSP checks a load module specified as an overlay for procedure only. 


OVLY LINK EXCEEDS TABLE 
LIMIT 


A system error to be reported. 


PROCESSOR OVERLAY SLOTS 
EXHAUSTED 


There are not enough empty processor overlay locations in the name table to 
fill the load module requirement. This check on the name table occurs during 
the write to the swap disk. 


PROCESSOR/OVERLAY 
ALREADY EXISTS 


User tried to ENTER a processor or overlay name that exists in the table. 


PRONAME IS ILLEGAL 


Some routine cannot be entered or replaced with DRSP (e.g. , XDELTA, 
RECOVER, GHOST1, ALLOCAT, M:DUMLM). 


PRONAME REQUIRED 


A program must be specified with the ENTER, REPLACE, and DELETE commands. 


RAD OVERFLOW 


Disk space allotted for the shared processors is exhausted. 


READ ERROR READING 
FID (COPY) 


I/O error detected while trying to read the processor for the copy into the 
system account. 


SWAP I/O ERROR (QUEUE) 


I/O error detected while writing processor to the swap disk. 


WRITE ERROR WRITING 
FID (COPY) 


I/O error detected while trying to write the processor into the system account. 
The processor is entered/replaced on non-"PERM" basis. 


WRITE RAD FILE I/O ERRORS 


I/O error detected while writing the processor to the swap disk. 
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Tabla 42. DRSP Informal- Ion Messages 



Message 


Meaning 


DRSP HERE 


* Routine title- typed when user fi."sr. enters DRS P. 


: ; DRSP INHIBIT SET 


.Arpther user is manipulating- the shared processor tables and prevents any 
other user executing the .ENTER, REPLACE, and DELETE commands. However, 
the LIST and LISTALL commands can be executed at any time. 


fid NEEDS xxxx GRANULES 


If DRSP cannot find sufficient disk space in any available slot, it feeds 
back to the user the number of granules required to enter/replace the 
new load module. 


proname REPLACED IN RAD 
SLOT #x 


While exercising the "PERM" option, the proname in slot ^x has been 
replaced by the proname specified in the current command. 


PRONAME FOUND ON RAD 


The proname already exists in the disk version of the processor tables when 
DRSP tries to execute the ENTER, PERM option. The "PERM" function is 
completed for the new copy. 


PRONAME NOT FOUND ON RAD 


The proname cannot be found in the disk version of the processor tables when 
DRSP tries to execute the REPLACE,PERM option. The "PERM" function is 
completed for the new copy. 


USERS ASSOCIATED 


DRSP attempts to replace TEL or CCI but finds there are users associated. The 
message is repeated periodically as long as users remain associated. 



Table 43. DRSP Command Summary 



Command 


Description 


D[ELETE] proname ,[PERM] 


Prevents further user association with a processor. 


END 


Exits normally from DRSP. 


EJNTER] proname[{™^}fidl 
[, optionj[, option)[, option] 


Enters a new shared processor into the system. 


L Mq-;]} 


Lists the processor name, the name table index, and the amount of disk 
space occupied by the processor. 


LB ™ L |!Eb3} 


Lists each shared processor name and its entries in certain tables. 


R[EPLACE]proname[j™°^} fid] 
[, option][, option][, option] 


Replaces an existing shared processor with a new shared processor. 


? 


Requests a detailed error message when an error has been noted by DRSP. 
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8. ON-LINE PERIPHERAL DIAGNOSTIC FACILITIES 



INTRODUCTION 

This chapter describes the system facilities that are designed 
for use by Xerox in the development of peripheral hardware 
diagnostic programs. The system procedures and the Diag- 
nostic DCB described in this chapter should never be used 
in any user-written programs. Their description is included 
in this manual only for completeness of documentation. Any 
program that uses them may seriously affect the operation 
and integrity of the system. 

The facilities described in this chapter are used in the fol- 
lowing types of Xerox processors: 

• Functional tests for peripheral devices that isolate hard- 
ware problems to the lowest possible level. 

• Exercisers that verify that the peripherals are operat- 
ing correctly. 

• Preventive maintenance tests that reduce the amount of 
time that peripherals are down for repair. 

These tests and exercisers may be run at an on-line terminal 
while the CP-V system is in normal operation. 

The facilities described in this chapter include one assem- 
bler directive, the special Diagnostic DCB (DDCB), and 
eight system procedures. The assembler directive allows the 
user to specify that a control section is to begin at a page 
boundary. The Diagnostic DCB is a data area that allows 
the user to issue his own I/O commands. 

These eight procedures reside in SYSTEM DIAG along with 
two other system procedures — M:DPART and D:DRET. 
(M:D PART and M:DRETare described In the SYSCON chap- 
ter in the CP-V/SM Reference Manual, 90 16 74, because 
they are used by SYSCON.) The eight system procedures 
perform the following functions: 

Procedure Function 

M:DDCB Generates a diagnostic data control 

block. 

M:DOPEN Opens the device associated with the 
Diagnostic DCB for diagnostic purposes. 

M:DCLOSE Terminates and inhibits all I/O associated 
with the Diagnostic DCB. 

M:BLIST Converts the user's virtual command list 

into a physical command list and stores 
the result in the Diagnostic DCB, or 
requests that a TIO, TDV, or HIO be 
performed on the device to which the 
Diagnostic DCB is opened. 

M-.SIO Initiates the user's I/O. The commands 

for the I/O are stored in the Diagnostic 
DCB. 



Procedure Function 

M:LOCK Either locks the user in core or resumes 

normal swapping for the user. 

M:MAP Converts a specified virtual address to a 

physical address or a specified physical 
address to a virtual address. 

M:DMOD# Obtains the controller model number, 
the device model number, and the type 
mnemonic associated with a given de- 
vice address, and availability informa- 
tion (i.e., device busy, device parti- 
tioned, controller partitioned, and DIAG 
key-in has been performed). 

RESTRICTIONS 

For both security and system performance reasons, there are 
certain restrictions on the use of the facilities described in 
this chapter. These restrictions are: 

1. The system manager must give approval before the sys- 
tem will process some of theCALs. (Note that M.-DDCB 
does not generate a CAL.) This approval is transmitted 
to the monitor via the operator key- in. 

!DIAG id 

where id is the diagnostic user's id and identifies the 
user as the current diagnostic user. This is reset by the 
monitor between job steps. 

2. The M:MAP procedure requires a privilege of AO or 
higher. The user is aborted if his privilege level is 
insufficient. 

3. The M:LOCK procedure requires a privilege level of 
AO or higher and the user must have been specified as 
the current diagnostic user via the DIAG key-in or 
have a privilege level of CO or higher. If one of these 
conditions is not met, the user is aborted. 

4. The M:DOPEN, M.-DCLOSE, M:BLIST and M:SIO pro- 
cedures require a privilege level of AO or higher and 
the user must have been specified as the current diag- 
nostic user via the DIAG key-in. If the conditions are 
not met, the user aborted. 

5. User registers SRI and SR3 are volatile for the 
M:DOPEN, M:DCLOSE, M:BLIST, M:SIO, M:LOCK 
and M:MAP procedures. 

PSECT DIRECTIVE 

The PSECT directive specifies that the control section which 
follows is to begin on a page boundary. This directive allows 
diagnosticians to ensure that such things as the Diagnostic 
DCB and buffers do not cross page boundaries. The PSECT 
directive is described in detail in the Meta-SymboI/LN, 
OPS Reference Manual, 90 09 52. 
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SYSTOS PROCEDURES .- • . 

Monitor procedures enable the user's symbolic Mera-Symboi 
program to request a variety of monitor functions. The on- 
line diagnostic procedures described in this chapter have 
the same general format as those described in the CP-V/BP 
Reference Manual, 90 17 64. 

When using Meta-Symbol, the monitor diagnostic procedure 
library is invoked via the directive 

SYSTEM DIAG 

This directive defines all of the monitor procedures. The 
Sigma 6 and 7 computer instruction set is invoked by the 
directive 

SYSTEM SIG7[F] [D] [P] 

where F specifies the floating-point option, D specifies the 
decimal option, and P specifies privilege instructions. 

The Xerox 560 and Sigma 9 computer instruction sets are 
invoked by the directive 

SYSTEM SIG9[P] 

where P specifies the privileged instruction set. 

i 
Thus, both the SYSTEM DIAG and the SYSTEM SIG7 or 
SYSTEM SIG9 directives should be used. The SYSTEM BPM 
directive should also be used if any of the procedures de- 
scribed in the CP-V/BP Reference Manual, 90 17 64, are 
used in the program. 



CREATE DIAGNOSTIC DATA CONTROL BLOCK 

M:DDCB The diagnostic data control block procedure 

generates a data area in the user's program that is accessible 
by the user. This data area must be given a label, the first 
two characters of which are F: (e.g./ F:DIAG). 

The Diagnostic DCB (hereafter referred to as the DDCB) must 
be used when the diagnostician is going to perform his own 
I/O through use of the diagnostic procedures described in 
this chapter. In addition to containing standard types of DCB 
information, the DDCB contains the user's I/O command list. 
The DDCB format is described in detail at the end of the 
chapter. Because the DDCB has its own format, theonly CALs 
that may be issued to the DDCB are the diagnostic CALs. 

The M:DDCB procedure call is of the form 

label M.-DDCB (DEVICE, name), (CLIST, n)[, (option)]. . . 

where 

label is a label that begins with the two characters F : 
and must previously have been declared a dummy 
section via a directive of the form 



DEVICE,name specifies the device that is to be 
associated with the DDCB. Name may be speci- 
fied in one of the following forms: 

1. A device type in. quotes (e.g., 'CR', 'LP'). 

2. An operational label in quotes (e.g., 'LO 1 , 
•EO'). 

-.' 

3. The physical address of the device expressed 
in hexadecimal (e.g., X'0080', X'0202'). 

CLIST, n specifies that n words are to be reserved 
for the user's command list. The maximum value 
that can be specified for n is 24. 

The options are: 



SN 



\.\, . , . ,l| specifies one of the 

r [ serial number JJ 



label 



DSECT 1 



following: 

1. The number of words (n) to be reserved for 
serial numbers. The serial numbers will be 
inserted into the DDCB when the DDCB is 
opened (M:DOPEN). The maximum value that 
can be specified for n is 12. 

2. The serial number of the volume to be used for 
input or output. There may be from one to 
twelve serial numbers of from one to four 
alphanumeric characters each. 

If the SN option is not specified in M:DDCB, then 
it cannot be specified in M:DOPEN. 

ABN, address specifies the symbolic address of a 
user's routine that is to be used to analyze any ab- 
normal conditions resulting from insufficient or con- 
flicting information. This address remains in the 
DDCB until it is overridden by an ABN specifica- 
tion in a DOPEN CAL. 

The CLIST and SN options produce variable-length param- 
eters which follow the fixed-length parameters in the DDCB. 
Each variable length parameter entry is preceded by a con- 
trol word of the following form: 

Byte is the code number (X'07' for SN; X'12' for 
CLIST). 

Byte 1 is the code for entry position (X'OO' means 

more parameter entries to follow; X'01' means last 
parameter entry). 

Byte 2 is, for the SN option, the number of signifi- 
cant data words in the parameter entry when serial 
numbers are specified. Otherwise it is zero. 

Byte 3 is the total number of words reserved for the 
entry, not including the control word (i.e., maxi- 
mum entry length). 
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Special Note : 

After generating the DDCB, Meta-Symool resumes assembly 
in the control or dummy section that was in effect when the 
MrDDCB procedure reference line was' encountered. In 
order to prevent the statements following the MrDDCB pro- 
cedure reference line from being assembled in the same sec- 
tion as the DDCB, one of the following is recommended: 

1. The control section directive preceding an M:DDCB 
reference line shouldbe a CSECT, and the DSECT asso- 
ciated with an M:DDCB should precede the CSECT. 

2. The statement immediately following an M:DDCB pro- 
cedure reference line should be either a CSECT or a 
USECT referencing a prior CSECT. 



OPEN DIAGNOSTIC DATA CONTROL BLOCK 



M:D0PEN j The monitor Diagnostic OPEN routine opens 
the device specified in the DDCB for diagnostic purposes. 
The DDCB will not be opened if the information in the 
DDCB is inaccurate, insufficient, or contradictory. If the 
M:DOPEN is made with no options specified, the existing 
parameters in the DDCB are used. If the DDCB is already 
open when the DOPEN routine is called, an abnormal con- 
dition issignaled. If the DDCB is not open when the DOPEN 
routine is called, the DDCB is reinitialized according to 
the parameters specified in the M:DOPEN procedure call. 

Symbiont devices will only be opened if they have been 
locked, suspended, or partitioned. Nonsymbiont devices 
and devices opened with a device address specified (as 
opposed to device typeor an operational label) must be par- 
titioned and not busy or allocated to an active user. Parti- 
tioning is accomplished by using SYSCON or as a result of 
a previous DC LOSE CAL with the PART option specified. 



The MrDOPEN procedure call is of the form ' 
M:D OPEN [*]dcb name, (DEVICE, [*]name), 
I (STATUS, [*]address)[, (option)]. . . 



whe 



PJdcb name specifies the name of the DDCB. 

DEVICE, [^name specifies the device that is to be 
associated with the DDCB. Name may be speci- 
fied in one of the following forms: 

1. A device type in quotes (e.g., 'CR 1 , 'LP'). 

2. An operational label in quotes (e.g., "LO 1 , 
'EO'). 

3. The physical address of the device expressed 
in hexadecimal (e.g., X'0080', X'0202'). 



STATUS; [*]addresr> specifies the address of the user^s 

, ' data area where the I/Osratus is to be stored. The 

status that is returned is in the same format cs for 

the Error Log (see/Appendix E). 

The options are: 

SN, 'serial numberT, 'serial number 1 ]. . . specifies 

the serial number(s) of the volume(s) that are to be 
used for input or output. The serial number may be 
from one to four alphanumeric characters. A re- 
quest for the volume(s)willbe sent to the operator's 
console when opening to a device type or opera- 
tional label, which the operator responds to with an 
AVR sequence (e.g., MOUNT key-in). 

NOERR specifies that records of errors from this de- 
vice are to be suppressed from the Error Log. How- 
ever, the user has the option of writing records to 
the Error Log himself, with the Write Error Log CAL. 

ABN, address specifies the symbolic address of a 
user's routine that is to be used to analyze any ab- 
normal condirfons resulting from insufficient or 
conflicting information. If an X'09' abnormal 
code occurs on the open, this open abnormal ad- 
dress is set info the DDCB and return is to this 
address. If an address is not present, the user is 
aborted. 



CHAN specifies that the controller is to be reserved 
for use by this diagnostic program. A controller 
may be reserved only if It is partitioned. 

Calls generated by the M:DOPEN procedure have the form: 

CAL1,6 fpt 

where fpt points to word of the FPT shown below. 

word 



X'05' 



0- 



-0 



DCB address 



1 2 314 S 6 7 18 9 10 lTTl2 13 14 15116 17 16 19120 21 22 23124 25 26 27128 29 30 31 



word 1 



0- 



12 3 14 5 6 7 18 9 10 II I 12 13 14 15l 16 17 18 191 20 21 22 23 1 24 25 26 27128 29 30 31 



word 2 - dev? c e code (PI) 



0- 



Device address 



1 2 3U 5 6 7 1b 9 10 III 12 13 14 15116 17 18 I9I20 21 22 23 1 24 25 26 27I2B 29 30 31 

device code (PI) alternate form 



0- 



-0 



TEXT oplabel 



I 2 3 14 5 6 718 9 10 11112 13 14 15(16 17 18 19120 21. 22 23124 25 26 27128 29 30 31 

where TEXT oplabel is an operational label in TEXT format, 
word 3 - STATUS (P2) 



-0 



Status address 



l 2 3 14 5 6 7 18 9 10 11112 13 14 I5H6 17 18 19120 21 22 23124 25 26 27128 2? 30 31 
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option ABN (P3) 



Abnormal address 



0l J 3 1 4 J 6 7 It 9 ia 111 12 13 14 IS Ik 17 I« ivl» 21 22 23124 25 24 2?l2S 29 30 31 



Flags f 1 through fr in word 1 of the FPT have the signifi- 
cance indicated below (when fj = 1). 



Flag 


Significance 


f , 


NOERR was specified. Error records are to 
be suppressed from the Error Log for this 
device. 


f 2 


CHAN was specified. The controller is to 
be reserved. 


f 3 


SN was specified. Serial numbers are pres- 
ent in the FPT (in the format described 
below). 


f 4 


An operational label was specified. Word 2 
of the FPT has the alternate form. 


f 5 


Reserved for future use. 



The format for the SN variable length parameter is identical 
to that in the DDCB. The variable length parameter entry 
is preceded by a control word of the form: 

Byte — Code number (X'07 1 ) identifying the variable- 
length parameter. 

Byte 1 —Code for entry position (X'OO 1 means more 
parameter entries to follow; X'OV means last 
parameter entry). 

Byte 2 — Number of significant data words in the pa- 
rameter entry (if SN). 

Byte 3 —Total number of words reserved for the entry, 
not including the control word (i.e., maximum 
entry length). 



If the user does not have at least AO privilege, the return 
is to CAL+1 with CO set. 



The M:DCLOSE procedure call is of the form 
M-.DCLOSE [*]dcb name 



" /PART \1 

, RETURN) 

tsAME J 



where 

[*]dcb name specifies the name of the DDCB. 

PART specifies that the device associated with the 
DDCB is to be partitioned from the system resources. 

RETURN specifies that the device associated with 
the DDCB is to be returned to the system resources. 

SAME specifies that the device associated with the 
DDCB is to remain in the same status (partitioned 
or not partitioned). The default is SAME. 

The Diagnostic CLOSE routine reports the status of the de- 
vice to the operator with the following message: 

,,f PARTITIONED! 
^ ndd lRETURNED ) 

where yyndd identifies the device. 

Calls generated by the M:DCLOSE procedure have the form 

CAL1,6 fpt 

where fpt points to word of the FPT shown below. 

word 



X'07» 



0- 



-0 



DCB address 



1 2 3!4 5 6 7 IS 9 10 111 12 13 14 151 16 17 18 19120 21 22 23124 25 26 27126 29 X 31 



word 1 



1 2 3 14 5 6 7 IB 9 10 111 12 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 

where 

f . specifies the PART option when set. 

f« specifies the RETURN option when set. 

f« specifies the SAME option when set. 

If the user does not have at least A0 privilege, the return is 
to CAL+1 with CC1 set. 



CLOSE DIAGNOSTIC DATA CONTROL BLOCK 

MlDCLOSE The Diagnostic CLOSE routine terminates 

and inhibits I/O through the DDCB. I/O cannot be per- 
formed through the DDCB until it is opened again. MrDCLOSE 
allows the user to specify whether or not the device is down 
(partitioned). 



BUILD COMMAND LIST 

' M:BLIST The monitor BLIST routine converts the user's 

virtual command list into a physical command list and stores 
the results in the DDCB. The routine validates that no 
command crosses a page boundary and that the number of | 
I/O command doublewords is less than or equal to 12. 
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The user's virtual commund '1st must- adhere to certain 
restrictions.;, ... 

© The list must use 'virtual rather than physical addresses. 

e* No input/oqtpur command doub! sword (IOCD) is- 

a Mowed to perforre. I/O across p page boundary or spe- 
cif/ a byte count greater than one page(X e 800' bytes). 

e The number of IOCDs must not be greater than 12. 

!• I/O commands which do not cause a transfer of data 
(e.g., skip file, rewind) must have a valid byte ad- 
dress and byte count. When such commands are used 
with the ICE flag, the I/O completion interrupt occurs 
immediately. Hence, the user must handle any desired 
I/O waitactivity independently of any I/O end action. 

The user may optionally request that the I/O be started. If 
this request is made, the monitor will not return control fo 
the user until either the request to start I/O has been re- 
jected, the I/O is complete, or the I/O has timed-out. The 
AIO, TDV, and TIO status and condition codes are returned 
in the user area specified by the STATUS parameter of 
M:DOPEN and in the exact format as for Error Log (see 
Appendix E). If a TIO, TDV, or HIO request is made, the 
appropriate request is executed and the status is returned in 
the user STATUS area in the format: 

word 



1- 






i 






1 





2 


3I4 5 6 


1 8 9 10 111 12 13 M 15ll6 1? 18 19l20 21 22 23 1 24 25 26 27 1 28 29 30 31 



words 1 and 2 



TIO, TDV, or HIO 



status 



"l 2 Trl S 6 Ttl 9 10 111 12 13 14 15 1 16 17 18 19(20 21 22 23 ! 24 25 26 27 i 28 29 30 31 



TIO specifies that a test I/O is to be performed. 

TDv' specifies ihai a test device is to be performed. 

HIO ;.' specifies that I/O is to be halted. 

The options are; * 

PRI/ [^priority specifies the priority of the I/O re- 
quest as a hexadecimal number (e.g., X'F6'). 
X' FO 1 is the highest priority and X'FF' is the 
lov/est priority. (The higher the priority, the 
higher the placement in the queue of requests for 
the channel containing the referenced device.) 
The default is X'FF'. 

SIO specifies that the I/O is to be started. 



TIMEOUT, [*]value specifies the minimum length 
of time allowed before an I/O timeout occurs. 
The value is in decimal and represents the number 
of 4. 8 second intervals prior to I/O timeout. For 
example, a value of 2 means a minimum of 9.6 
seconds before timeout.. For spindles or disk packs, 
the maximum value used is one even if a larger 
value is specified. The maximum value accepted 
for all other devices is 63 and the minimum is 1. 
A value greater than 63 will be forced to 63 and 
a value less than I will be forced to one. The 
default is one. The actual time allowed before 
an I/O timeout occurs ranges from a minimum 
timeout of "value" * 4. 8 seconds to a maximum 
timeout of "value+I" * 4.8 seconds depending on 
when the timeout count was initiated. Therefore, 
a TIMEOUT value of 2 may cause a timeout with- 
in a range of 9. 6 to 14.4 seconds. 



word 3 



CC 



4 5 6 7 18 9 10 11112 13 14 15 



Device address 



16 17 18 19120 21 22 23124 25 26 27128 29 30 31 



where 

CC instruction's condition codes. 

Device address device address from DDCB. 

The M:BLIST procedure call has the form 

M.-BLIST [*]dcb name,f(ADR, [*]address)[,(option)]. .. 

TIO 
TDV 
HIO. 

where 

[*Jdcb name specifies the DDCB. 

ADR, [*Jaddress specifies the address of the user's 
command list. 



Calls generated by the M.-BLIST procedure have the form: 

CAL1,6 fpt 
where fpt points fo word of the FPT shown below. 

word 



X'09' 



1 2 314 567 

word 1 



DCB address 



8 9 10 111 12 13 14 15ll6 17 18 I9I2O 21 22 23 1 24 25 26 27 1 28 29 30 3 



•0 



1 2 3 U 5 6 7 I 8 9 10 111 12 13 14 15! 16 17 18 19 

word 2- APR (PI) 



24 25 26 27128 29 30 31 



0- 



Command list address 



1 2 3 U 5 6 7 I 8 9 10 111 12 13 14 15 1 16 17 18 19l 20 21 22 23 1 24 25 26 27 1 28 29 30 31 

option PRI (P2) 



0- 



-0 



Priority 



1 2 3 I 4 5 6 7 I A 9 10 III 12 13 U 1st 16 17 li 19 I 26 21 22 h l U 25 26 27 i 28 29 30 31 
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option TIMEOUT (P 3 > 



-0 



Timeout vtiiue 



oM l i \ * i t > ~ U I 16 lt l li U u'i5lw l> lit rf l id it.*! Il l K ■& HMh H Kit ' 

where 



f« 



is set to one if SIO was specified. . Otherwise, 
it is set to zero. 

Is set to one when a TIO, TDV, or HIO is re- 
quested. Otherwise, it is set to zero. 

is set to one for a TIO request. 

is set to one for a TDV request. 

is set to one for an HIO request. 



If Incorrect or conflicting information exists, the abnormal 
address specified In the DDCB will be used if it has been 
specified. If the user does not have at least A0 privilege, 
the return is to CAL+1 with CO set. 



START I/O 

M'.SIO The start I/O procedure callinitiates the diag- 

nostic I/O specified in the diagnostic DDCB. After an SIO, 
the monitor will not return control to the user until either 
the call has been rejected, the I/O has been completed 
(successfully or with errors) or the I/O has timed-out. The 
AIO, TDV, and TIO status and condition codes are returned 
in the user area specified by the STATUS parameter of 
MrDOPEN and in the exact format as for Error Log (see 
Appendix E). 

The M:SIO procedure call is of the form 

M:SIO [*]dcb name 

where [*Jdcb name specifies the DDCB. 

Calls generated by the MtSlO procedure have the form 

CAL1,6 fpt 
where fpt points to word of the FPT shown below, 
word 



X'03' 



DCB address 



61 1 3 I « S 6 7 11 » 10 111 11 13 u Ijtit 17 II 191X1 II » islll 15 M v\)t )» 30 II 



If there is no command list in the DDCB or the validity of 
the command list has been destroyed by a swap, an abnor- 
mal condition results. If the user does not have at least A0 
privilege, the return is to CAL+1 with CC1 set. 



lock is* mm 

MlLOCK The LOCK routine either locks the user in 

core or resumes normal swapping for the user. This lock in 
core reduces the user's chances of being swapped but does 
not ensure that the user will' not be swapped. The user may 
ascertain whether a swap has occurred since the BUST CAL 
by comparing J:NRS (the swap count) in the JIT with the 
SWAPCT field in the DDCB. (SWAPCT contains the swap 
count at the time of the BLIST CAL. ) The user has not been 
swapped if the two values are equal. (The external refer- 
ence J:NRS is satisfied by loading with :J0 from the :SYS 
account. ) 



The M:LOCK procedure call is of the form 



M:LOCK Q 



where 

YES specifies that the user is to be locked in core. 

NO specifies that normal system swapping is to re- 
sume for the user. 

Once a user is locked in core, his size may not change. 
Use of the following services may result in a size modifica- 
tion. In such case, the user will be swapped. 

1 . Memory management CALs. 

2. MrSEGLOAD, M.-LINK, and M:LDTRC procedure calls. 

3. Associate and disassociate processor CALs. 

4. Get page CALs. 

Calls generated by the M:LOCK procedure have the form 

CAM, 6 fpt 
where fpt points to word of the FPT shown below, 
word 



X'04' 



t t 1 1 1 4 5 * rll » 10 llllj 1} 14 is! I* 17 II l»t» II 11 }3h< 75 }6 17 1 11 14 R3 

word 1 



.0', 



I 1 314 I I 'II • It I" 17 II 14 IIII* 17 II 1*1 30 31 33 13124 75 7» 77118 1» 10 J' 

where f] in word 1 specifies that LOCK in core has been 
requested (f » = l)or that the LOCK is to be released (f] -0). 

If the user's privilege level is not at least A0, the return is 
to CAL+I with CC1 set. 
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CONVERT ADDRESS 

M:MAP The M:MAP procedure converts o specified 

virtual address to a physical address or a specified physical 
address to a virtual address. The converted address is stored 
in general register 8. The M.-MAP procedure call has the 
form 



M:MAP (™), (ADR, '[*] address) 



where 

VTP specifies virtual to physical address conversion. 

PTV specifies physical to virtual address conversion. 

ADR, [*] address specifies the location of the address, 
to be converted. 

If the user has been swapped in between issuing a BLIST CAL 
and issuing a MAP CAL, the address returned from the MAP 
CAL is invalid. The user has not been swapped if J:NRS in 
the JIT is equal to SWAPCT in the DDCB. The user may 
reduce the chances of being swapped through the use of 
MrLOCK. 

Calls generated by the M:MAP procedure have the form 

CAL 1,6 fpt 

where fpt points to word of the FPT shown below. 

word 



X'02' 



Address 



fl' l 1 )U ! t HI ! \t> »l l » H u \l \ U V It H t » il H «I2< » k P l » Vf X M 

word 1 



0- 



-0 



") i \ i 3 6 7 I t i to 11 1 12 U ' U ' \i \ \t \) U t* 



0- 



-0 



i\ ii ii \ U ' M ' fc tt t H » as t 



where fi indicates virtual to physical address conversion 
(f] =0) or physical to virtual address conversion (f ] = 1). 

If the user's privilege level is not at least A0, the return is 
to CAL+1 with CC1 set. 



0BT/UU BS0DEL HU&BERS AED TYPE MBEKIGKICS 

M:DM0D# The M:DMOD # procedure obtains the con- 

troller model number, the device model number, the type 
mnemonic associated with a given device address, and 
specific information concerning the device (i.e., device 
availability, device partitioned, controller partitioned, 
and DIAG key-in has been performed). 

M:DMOD # [*]device address 

where device address has the form ndd in which n specifies 
the IOP unit address (the number associated with the IOP 
letter; see Table B-2 in Appendix B) and dd specifies the 
device number (see Table B-3 in Appendix B). 



Example: 

M:DMOD* X'20F' 

The procedure verifies that such an address exists. If no such 
device address exists, CC1 is set to one. However, if the 
device address is valid, CC1 is set to zero and the following 
general registers are set: 

R8 contains the device model number in hexadecimal 
(e.g., X'00007122'). 

R9 contains the controller model number in hexa- 
decimal (mg.r X'00007120'). 

R10 contains the type mnemonic in EBCDIC and 
right-justified (e.g., X'0000C3D9' for CR), and 
special information flags formatted as follows: 

bit 0=1 device is currently busy with an- 
other user. 

bit 1 = 1 device is partitioned. 

bit 2 = 1 device's controller is partitioned. 

bit 3 = 1 DIAG key-in has been made by 

the operator. 

bit 4 = 1 sub-channel 2 (alternate path) 
partitioned. 

bit 5 = 1 sub-channel 1 (primary path) 
partitioned. 

In either case, the return is to CAL+1 . 

Calls generated by the M:DMOD' procedure have the form 

CAL1,6 fpt 
where fpt points to word of the FPT shown below. 

word 



X'OA' 



Device address 



1 1 3 I * 5 6 7 I I ♦ 10 Ilil2 13 14 isl M> 17 l« 1»!» 21 22 »l}4 2S 26 27 1 28 2» 30 31 

word 1 



1 0- 



I J J I 4 5 * 7 II * K> III 12 13 14 15 1 16 17 II 19 1 JO 21 22 1}\}* 25 26 2? 1 28 29 30 31 

M:DM0DX The M:DMODX procedure obtains the 

same model numbers and type mnemonics as the M:DMOD* 
procedure. The format for both procedures is the same: 

M:DMODX [*] device address 

All M:DMOD' information is applicable to MrDMODX, 
except for word 1 of the FPT. Word 1 of the FPT for 
M:DMODX is shown below. 



word 1 






1 


00 


F2 


ft n 


u u 



12 3 4 



If F2 is set, word contains a DCT index 
(in positions 8-31). 



31 
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If F2 i' 0, word contains a device address^ 
(same as M:DMOD*<). 

If on invalid DCT index (DCTX) is passed, the 
MrDMOD* error conditions apply to MrDMODX.' 



(bUs 8~14)are returned in user's register SR3 and the addrai* 
of the.procedure plus one word (CAL+1) is returned in ussr's 
register: SRI. (The messages reside in the -system error meii- 
age file, ERRMSG.) 



ABNORMAL COOES AND MESSAGES 

The codes and messages for abnormal conditions that can 
occur when using the on-line diagnostics facilities are listed 
in Table 44. The abnormal code (bits 0-7) and subcode 



DDCB 

The format for the DDCB is given in Figure 16. Following 
each format, the parameter fields of the DDCB are described 
In alphabetical order by their mnemonic. All referenced 
addresses have word resolution. 
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Table 44, On-Line Diagnostics Abnormal Messages 



Abnormal 






Code 


Subcode 


Meaning of Code 


09 


00 


A diagnostic close is attempting to return a nonpaffitioned devrce or a device Within a parti- 
tioned controller. 


09 


01 


The device referenced in the DDCB is a nonexistent device. 


09 


02 


The device referenced in the DDCB is currently in use. 


09 


03 


The device referenced in the DDCB is currently in use by a symbiont. 


09 


04 


The DDCB does not contain a command list. 


09 


05 


The command list was invalidated by a swap. 


09 


06 


There are more than 12 I/O command doublewords (lOCDs). 


09 


07 


The I/O command list is invalid due to either invalid flags, an invalid TIC address, an invalid 
user-specified command list address, or insufficient room in the DDCB for the command list. 


09 


08 


An error was found during the BLIST CAL Either an invalid page was found during physical-to- 
virtual or virtual-to-physical address conversion, the status address is in error, or the byte count 
is illegal in the IOCD. 


09 


09 


A buffer crosses a page boundary. 


09 


0A 


The user's ID does not match the ID specified on the last operator DIAG key-in, or the user 
privilege level was less than A0. 


09 


0B 


The amount of available core is not sufficient to allow the diagnostic program to lock itself 
in core. 


09 


OC 


The requested controller is not partitioned. 


09 


0D 


The device specifically requested on an open is not partitioned. 


09 


0E 


A MAP CAL error occurred due to an invalid page number during a physical -to- virtual or 
virtual-to-physical address conversion. 


09 


OF 


Monitor buffer space (MPOOL) is unavailable for processing the command list. 


09 


10 


A hand-coded TIO, TDV, or HIO type FPT does not have f$, f^, or f^ set to one when 
f2 is one. 


09 


11 


A CHAN option on an MrDOPEN to a device type or operational label is illegal. 
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Word 




















TTL 


>1 c c 


W 
A 
T. 










12 3 1 4 5 6 7 


ii 9 io rn 

1 1 ,i - 


\U\2 14 \5 


16 17 18 19 1 20 21 22 23124 25 26 27 i 28 29 30 31 






ffiSBK&S: 


: ; :v: : ; : : : :v: ; : : : : : : : : :v:^ 


FUN 


T 
O 
L 
F 


D 
£ 
V 
F 





TYPE 


DEV or OPLB 




: . : - : . '.'.••• ' • '. ■. '. • . . 






12 3 14 5 6 7 
Word 2 


8 9 10 111 12 13 14 15 


16 17 18 19120 21 22 23 


24 25 26 27I28 29 30 31 











BUF 






12 3 14 5 6 7 1 
Word 3 


8 9 10 111 12 13 14 


15116 17 18 19120 21 22 23 1 24 25 26 27 1 28 29 30 31 

-H , . 


1 IMtUUI 
1 2 3 1 4 5 6 7 

Word 4 


8 9 10 11 f 12 13 14 


tKA 
15116 17 18 19120 21 22 23 1 24 25 26 27 1 28 29 30 31 

-H 1 ■ * — 


CLSZ 




ABA 




1 2 3 1 4 5 6 7 
Word 5 


8 9 10 11 1 12 13 14 


IS 1 16 17 18 I9I2O 21 22 23l 


24 25 26 27 1 28- 29 30 31 







D 
I 

A 
G 


' | ' } -v1,c,*v>"v Rt^."---" - 


'"- f? v USVf ''J' ' ^"^^ 





T 
O 
P 









1 ■^/'' •> -.ss* -*•"• '"* 


•I ,-«,' -•■ ',,,', ' v. '* •>'' 


A, s o-'*, - S 


1 
Word 


2 
6 


3 14 5 6 7 1 8 9 10 1 1 1 12 13 14 15 1 16 17 18 19 1 20 21 22 23 


24 25 

1 


26 


27128 29 30 31 


• •". . • ••«"•:•.! $ •>.•:••• '•.. . . * • . !".••""• 


FLP 


1 2 z\a 5 6 7 I 8 9 10 111 12 13 14 
Word 7 


15 1 16 17 18 19l20 21 22 23 1 24 25 26 27I28 29 30 31 

\ , 1 „ 









* 1^ -^ * ^-d 








6 1 2 III 5 6 7 18 9 10 uTl2 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 





Figure 16. Format of the DDCB 



122 DDCB 



: —— — v " """ ' " : '"■■ ■ ■ ■ ...—-.. «,..——». — , 


Word 8 , _ / j 




i ...... ....... — — T — ... , ... . _.,, , , 

' '..■■'■'■•■ n 1 




W . ■ . . - •" ■■. -- ' :-'- ' U j 


| 






j 




1 2 3 14 5 6 7.I.& 9 10 111.12 13 14 15116*17 18 19120 '21,22 231.24 25' 26 27 1 28 29 30 31 






Word 9 ,.■'■■' , 






(may not be used) 


'"■> J J J:!! !""■•'••■. " '. .•"•".•:::•■ :."+. ■ • w ; .•-.•':•*..•.•..'. 




."•*'*..'• ' . *■ ' • " ' **!*:*. 


|:j:|;::|;i:|||li||$l|||:i:|i| 


< ' » • * ■■!-»*■ . 1 1 




12 3 14 5 6 7 


8 9 10 11112 13 14 15 1 16 17 18 19120 21 22 23124 25 26 27128 29 30 31 






Word 10 








KBUF 






■ :: ' : ": : :: : .•:.-.•.'•": : : : " ' : ' : :: - : : ?: : 'v' . • .:. : . . •. •' ' • : 






1 2 3 14 5 6 7 18 9 10 11 1 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27128 29 30 31 






Word 11 








_ 


C 


. '• • '•'•• • •: • ' :: :' •:'•';•' ' 






COS or CIS 


'■':.'....'".::....'.. ..,:....'< 


H 
A 
N 


'•. • • •. •.' . ; ' : : - ' • / &(.. '"'... 




1 


12 3 14 5 6 7 


8 9 10 11 112 13 14 15 


16 17 18 19l20 21 22 23I24 25 26 27128 29 30 31 




* 


■Word 12 - , . 








DEVICE 




1 2 3 i 4 5 6 7 1 8 9 10 111 12 13 14 


15ll6 17 18 19l20 21 22 23l24 25 26 27 1 28 29 30 31 




Word 13 






1 2 314 5 6 7 1 8 9 10 11 1 12 13 14 15116 17 18 I9I2O 21 22 23J24 25 26 27?28 29 30 31 






Word 14 


CTA 




1 2 3 14 5 6 7 18 9 10 111 12 13 14 


15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 




Word 15 , 






TAB1 






1 2 3 14 5 6 7 18 9 10 11 1 12 13 14 15l 16 17 18 19l20 21 22 23l24 25 26 27 1 28 29 30 31 
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DDCB 123 



Word 16 



; *TW'.*4«<«W»* v^- •■■ 



>.«W*YT?W»1WP-"^-f- ■ 



r.f-p wwj/^v* ';* ■■'~t*>rm^.'wc*«rF 



S iTTl4 5 6 7T8 9 10 nuTTs 14 15l 16 17 18 i?i2G 2] 22' 23)24 2526 27\2b 2930 31 



Word 17 



■y^wMay^O ^L^L wy^ ^ .11, VI I * )\Vf V >' 7 j ????yTWffWf' 



IT 1 2 "'3 "l 456TTTT"T^1^rr^^ 2>'l 28 29~30 31 



Word 18 

WWWWWJS 



:: : $:£ W- : S : S : - : ^ : : : x-:#: : : : : : : : : : : : :*& : >: : : ; : : : : - : : : x : x : : : :v': v:X:y::^ 

1 2 31456 718 910 111 12 13 14 151 16 17 1819120 212223124 252627 1 28 29 30 31 




Word 19 



ate 



SWAPCT 



1 2 3145 6 7 18 9 10 Ti I 12 13 14 15 1 16 17 18 19 1 20 21 22 23^4 25 26 27 1 28 29 30 3~ 
Word 20 



*fc 



S*r 



b"""i" 2 " 3 I 4 5 6 7 18 9 10 111 12 13 14 151 16 " 17 18 19 120 2 1 " 22 " 23 T24" 25 26 '27t*28 29 30 3t 



Word 21 








PRI 


JSSSSSvKv:;^ 


CLIST 


■■'• / ! ' -I'.-:; - :%.:::..:......!... '' "" .' 


1 2 


3 14 5 6 7 


8 9 10 11 112 13 14 


15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



Words 22 — n are used for variable length parameters 



Figure 16. Format of the DDCB (cont. ) 



FIELD 
ABA 

ASN 

BUF 

CHAN 

CIS 



DESCRIPTION 

Contains the address of the user's routine that will handle abnormal conditions resulting from 
insufficient or conflicting information. 

Indicates the assignment type currently in effect for the DCB (0 = null, 1 = file, 2 = Xerox 
labeled tape, 3 = device, X'A' = ANS labeled tape). 

Contains the address of a monitor MPOOL buffer used when processing the user's command list. 
Is the controller reservation flag (0 = no, 1 = yes). 

Contains the relative position of the serial number (in the SN list) of the magnetic tape reel 
used for current file input. 



WORD 



2 
11 
11 
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FIELD 



DESCRIPTION 



WORD 



CLIST Contains the virtual, address of the* physical command list in the DDCB. 21 

CLSZ Contains the number '-of words in the physical command list in the DDCB. 4 

COS Contains the relative position of the serial number {in the SN list) of the magnetic tape reel II 
used for current file output. 

DEV Contains the DCT index of the device assigned to the DCB. DEV is only meaningful if DEVF 1 
is set to one. •; 

DEVF Indicates whether the DDCB is assigned to a device or an operational label (0 = operational 1 
label, 1 = device). 

DEVICE Contains the EBCDIC name specified on the DEVICE option in the MrDOPEN call. 12 

DIAG Indicates diagnostic device DDCB. 5 

DRC Is the format control flag and indicates whether (DRC = 0) or not (DRC = 1) the monitor is to do 
special formatting of records on read or write operations. DRC is always set to 1 in a DDCB. 

ERA Contains the address of the user's routine that will handle error conditions resulting from 3 
insufficient or conflicting information. 

FCD Indicates whether the DDCB is opened or closed {0 = closed, 1 = opened). 

FCI Indicates whether the DDCB has ever been closed. The flag is set when the DDCB is first closed, 
and then is never reset (0 = DDCB has never been closed; 1 = DDCB has been previously opened 
and closed). 

FLP "Contains the address of the variable length parameters in the DDCB (called the file list-pointer). 6 

FUN Contains the device mode function (0 = null, 1 = IN, 2 = OUT, 3 = IN and OUT, 4 = INOUT, 8 = OUTIN). 1 

KBUF Contains the virtual address of the user's command list. 10 

OPLB Contains the OPLB table index of the operational label assigned to the DDCB. OPLB is only 1 
meaningful if DEVF equals 0. 

PRI Specifies priority of I/O request. 21 

STA Contains address of user data area used fo return I/O status. 14 

SWAPCT Contains user's swap count at the time a diagnostic CAL is issued. 19 

TAB1 Contains the physical doubleword address of the command list in the DDCB. 15 

TIMEOUT Contains the I/O timeout value from the M:BLIST CAL. 3 

TOLF If 1, bits 16-31 of DDCB are TEXT OPLABEL. If 0, DEVF is meaningful. 1 

TOP If 1, opened to a device type or op label. Otherwise, set to 0. 5 

TTL Specifies the length of the DDCB in words. 

TYPE Contains the device type code assigned to the DDCB. This field is set whether the DDCB is assigned 1 
directly to a device or indirectly through an operational label. 

WAT Is the wait flag and indicates whether (WAT = 1 ) or not (WAT = 0) WAIT was specified for the I/O. 
WAT is always set to 1 in a DDCB. 
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9. ReAL-TiMS PROCEDURES 



Real-time processing involves reacting to external events 
(including clock pulses) within microseconds. Selected ex- 
ternal events are' allowed to interrupt the real-time user's 
program so that they can be processed at the time they 
occur. After an interrupt has .been. processed, control may 
then return to the interrupted program or m6y be directed 
elsewhere. 



Waiting 

When an interrupt in the armed state receives an interrupt sig- 
nal, it advances to the waiting state, and remains in the waiting 
state until it is allowed to advance to the active state. 

Enabled 



In CP-V real-time processing, there are three distinct types 
of interrupts: 

1. Real, hardware interrupts. 

2. Multiple clock interval interrupts derived through soft- 
ware from a single hardware clock interrupt. 

3. User written pseudo-interrupts that are triggered by 
software rather than by hardware. This type of inter- 
rupt is quite useful for interprogram communication 
and synchronization. Pseudo-interrupts use interrupt 
addresses X'1000' through X7FFF'. 

Note: Any interrupt connected by real-time procedures 
must have a hardware priority below that of the I/O 
interrupt. Note also that the swapper performs I/O 
at a software priority, of X'10'. (This would be a 
consideration when specifying a priority to be as- 
sociated with certain real-time I/O requests; e.g., 
MrlOEX.) 

The counter- equals-zero interrupts (X'58 1 and 
X'59') may be connected to a user program via 
the M:CONNECT or MrGJOBCON procedures. 
However, it is the user's responsibility to initialize 
the corresponding counter pulse interrupts (X'52 1 
and X'53'). 

CP-V real-time provides services that allow a user program 
to connect to and control interrupts, to request interruption 
at specified clock intervals, and to lock itself into core so 
that it will not be swapped out until it is ready to be 
swapped out. 

The following terms appear in the discussion of the real- 
time services: 



When an interrupt is in the enabled state, it is allowed to 
move to the active state when the interrupt signal is received 
provided that it is also in the armed state. If the interrupt 
is already in the waiting state, it moves to the active state 
when it becomes enabled, provided that no higher priority 
interrupt is currently active. 

Disabled 

An interrupt can undergo all state changes except that of 
moving from the waiting to the active state when it is in the 
disabled state. 

Active 



When an interrupt meets all of the conditions necessary to 
permit it to move from the waiting state to the active state, 
it is permitted to do so by being acknowledged by the com- 
puter, which then executes the contents of the assigned in- 
terrupt location as the next instruction. 

Cleared 



When an interrupt is changed from the active state to the 
cleared state, the interrupt states are reset so that the in- 
terrupt can be recognized again and the priority is reset to 
that of the job that was running when the interrupt occurred. 

Interrupt Control Blocks (ICBs) 

Areas of memory set aside for use by the monitor interrupt 
processing routines. ICBs are established by SYSGEN. 

Interrupt Label 

The two-character name of an interrupt. Interrupt labels 
are defined at SYSGEN. 



Disarmed 

When an interrupt is in the disarmed state, no signal to that 
interrupt is admitted; that is, no record is retained of the 
existence of the signal, nor is any program interrupt caused 
by it at any time. 

Armed 



INTERRUPT CONNECTION AND CONTROL SERVICES 

CP-V real-time provides services that connect interrupts to 
mapped programs, control the state of interrupts (e.g., trig- 
ger, arm, enable, disable), clear interrupts either at time 
of occurrence or upon completion of processing, and discon- 
nect interrupts that are no longer required. Most of these 
services are provided through procedures which, except 
where noted, reside in 



When an interrupt is in the armed state, it can accept and 
remember an interrupt signal. The receipt of such a signal 
advances the interrupt to the waiting state. 



SYSTEM RTPROCS 



and require real-time privilege (EO or higher). 
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CONNECT INTERRUPT TO GHOST FILE 



word 



M:GJ0BCON The GJOBCON routine associates an 

interrupt with a load module such that if the interrupt oc- ■ 
curs, the designated load module will be put into execu- 
tion as a ghost job. If the ghost job is already active as 
the result of a previous interrupt/ the interrupt wi I be 
ignored. An interrupt occurring while the ghost is asleep 
(M:WAIT) causes a wake-up event. Once connected to the 
interrupt, the designated ghost job behaves as a subtask of 
the program that issued the M:GJOBCON. If the program 
exits or aborts, the ghost job is disconnected from the 
interrupt and (if running) is aborted. 

The MrGJOBCON procedure call has the form 



M:GJOBCON <>NU-](i; , *;;; , , p, }>, 



c 



(LMN, 'load module')[, (ACN, 'account')]- 



ZJ 



,(PRIO, [^priority)] 



where 



INT, [*j interrupt specifies an interrupt address. 

INT, [*]*intlbl' specifies an interrupt label. If 
indirect addressing is used, the label must be in 
* EBCDIC format, right-justified in the word, and 

preceded by blanks. 

LMN,'load module 1 specifies the name of the load 
module to be placed in execution when the inter- 
rupt occurs. This will be the name of the re- 
sulting ghost job. The name must be seven char- 
acters or less in length. 

ACN, 'account* specifies the account of the load 

module and consequent running account for the 
ghost job. The default is the :SYS account. 

PRIO, [*Jpriority specifies the execution priority 
for the ghost job. The default is as follows: if 
'inflbl* was specified (via the INT keyword), the 
default is the SYSGEN-defined execution prior- 
ity associated within the interrupt label; if an in- 
terrupt address was specified (via the INT key- 
word) and the interrupt is a real interrupt, the 
default is n-X'4F' where n is the value of the 
interrupt address (e.g. , programs attached to in- 
terrupt level X'60' would have a default execu- 
tion priority of X' 1 1 '); if an interrupt address was 
specified (via the INT keyword) and the interrupt 
is a pseudo interrupt, the default is the SYSGEN- 
defined default execution priority for ghost jobs. 

Calls generated by the M:GJOBCON procedure have 
the form 

CAL1,5 fpt 

where fpt points to word of the FPT shown below. 



I } '1 . 4. 5> 6 ? 



a _ _^_ jt Interrupt address 

•. • • pnterropt label (TEXT format) 

» '»• 10 lilt: I) 14 Ijll6 O l> tilK ?' 1J }'}) !*.}•: 2a }'h» 2? .1 ■■> 



word 1 



o- 







I I I ill 5 « ?\t ♦ 10 111 13 13 u >sll6 IT . 1» I«lj0 It 22 2}\ }t 25 2» lAli J» X }' 



words 2 and 3 



Load module name in TEXTC 



format (57 characters) 



I 2 ) l< T - ? Tt"« 5 10 111 12 13 14 111 16 17 18 I»lj0 Jl 22 2jl2« ?i 2» 2?\n 2» X 3 



words 4 and 5 (PI) 



Account name in TEXT 



format (58 characters) 



6 I } 1 \i i * > t* * 18 HlU II 14 IS I 14 17 It 1*1*) II H h\i* 25 26 2?l>t 29 



word 6 (P2) 



01 1 ll« 5 t 7 I 8 9 10 llllj IJ 14 111 14 17 II 1»1» 21 22 21 



Priority 



24 23 24 27 1 28 27 20 31 



Condition code settings resulting from an M:GJOBCON 
CAL are: 

CC1 - set if the user does not have real-time 

privilege. 

CC2 - set if no interrupt control blocks are 

available. 



CC3 - set if the interrupt specified is already 

connected. 



CC4 - set if the ghost already exists. This 

MrGJOBCON procedure call is ignored. 



CONNECT USER PROGRAM TO INTERRUPT 

M: CONNECT Any mapped user program with real-time 

privilege may use this service to establish a connection to 
an interrupt such that the user program will be entered at 
the specified address when the interrupt occurs. Interrupts 
connected in this way report events to the CP-V execution 
scheduler and therefore permit the entered program to use 
all monitor services. The connected interrupt will be armed 
and enabled or disabled as specified by the user. 
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The M-.CONNECT procedure call has the form 



M:CONNECT 0NT / H{|? n ^ p, j) # ..-- 



word 1 



(ENTRY,[*]address)[,CLEAR][,' MASTER] 



•[, DISABLE^, (PRIO,[*]priority)] 



where 

INT, [*]interrupt specifies an interrupt address. 

INT, ^J'intlbl' specifies an interrupt label. If 

indirect addressing is used, the label must be in 
EBCDIC format, right-justified in the word, and 
preceded by blanks. 

ENTRY, [*]address specifies the address at which 
entry is to be made into the user program. 

PRIO, [*]priority specifies the execution priority 
for this interrupt. The default is as follows: if 
'intlbl' was specified (via the INT keyword), the 
default is the SYSGEN-defined execution priority 
associated with the interrupt label; if an interrupt 
address was specified (via the INT keyword) and 
the interrupt is a real interrupt, the default is 
n-X'4F' where n is the value of the interrupt 
address; if an interrupt address was specified (via 
the INT keyword) and the interrupt is a pseudo 
interrupt, the default is the SYSGEN-defined 
default execution priority for either on-line, 
batch, or ghost jobs, depending on tfie mode 
in which the job is being executed. 

CLEAR specifies that the interrupt is to be cleared 
immediately upon occurrence and reported to the 
scheduler. The default is to leave the interrupt 
active. 

MASTER specifies that the user is to be given con- 
trol in the master mode. The default is the slave 
mode. 

DISABLE specifies that the interrupt is to be con- 
nected, armed, and disabled. The default is to 
arm and enable. 

Calls generated by the M:CONNECT procedure have the 
form 

CAL1,5 fpt 

where fpt points to word of the FPT shown below, 
word 



X'21' 



oi i J I * s~5 f 







• » 10 III 12 13 M 1J 



Interrupt address 

Interrupt laljeT(TD<T~TormqtT 

i6 i7 it i»ijo }i u mIm 25 i» vin r» » 31 



1 


p 
1 


n 


M 


c 


.... 








1 


j }!« 


5 t, 


1 1 


10 III 12 ! 


14 111 16 17 I 


i 19120 2 


1 22 731 24 2 


i 26 27128 


2» 


30 


3t 



word 2 



Entry address 



1 I 3 I 4 S « 7 I t 1 10 III 12 13 I* IS I 16 17 It I? 1 20 21 22 n\j* 21 26 v\it 29 33 31 

word 3 (PI) 



Priority 



B 'l 1 )U i i Mi Mil U l l} H U ti t 14 )? 19 n \ » i\ » «t» }i li » \ » » ' » i T 

where 

M=1 specifies MASTER mode. 

C=l specifies CLEAR. 

0=1 specifies DISABLE. 

condition code settings resulting from an M:CONNECT 
CAL are: 

CC1 - set if the user does not have real-time 

privilege. 

CC2 - set if no interrupt control blocks are avail- 

able. (Interrupt control blocks are estab- 
lished at SYSGEN.) 

CC3 - set if the interrupt specified is already 

connected. 

The environment existing for the real-time program at the 
time of the interrupt occurrence is saved in the user's TCB 
before entering the specified interrupt routine. The TCB is 
identical to the one shown in Figure 5 except that the last 
word contains the interrupt location rather than a trap 
location. 



DISC08KECT USER PROGRAM OR 6H0ST JOB 
FROM IHTERRUPT 

MjDISCOKHECT The DISCONNECT routine releases 

the specified interrupt if it is associated with the current 
user. If honored, the M:DISCONNECT procedure disarms 
the specified interrupt and releases the associated interrupt 
control block. 

The M:DISCONNECT procedure call has the form 
M:DISCONNECT ONU^!^^}) 



where 



INT, [*]interrupt specifies the interrupt address. 

INT, [*J'intlbl* specifies the interrupt label. If in- 
direct addressing is used, the label must be in 
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EBCDIC format, right-justified in the word, 
and preceded by blanks. 

Calls generated by the M:DISCONNECT procedure have 
the form 

. CAL 1,5 fpt , 

where fpt points to the FPT shown below. 



X'22' 



Interrupt address 

Interrupt lal>eT(tT5?tTorrnaTy 

T20 



2 > ! 4 J 6 7 18 » 10 III 12 13 14 :jl 10 17 IS 1»I20 21 21 23124 U 24 27128 29 30 31 

Condition code settings resulting from an M:DISCONNECT 
CAL are: 

CC1 - set if the user does not have real-time 

privilege. 

CC2 - set if the interrupt specified is not associ- 

ated with the current user. 

CC3 - set if the specified interrupt is currently 

active. 



CONTROL AN INTERRUPT 

MllNTCON This service permits a program with real- 

time privilege to control the states of interrupts. Interrupts 
may be armed, disarmed, enabled, disabled, or triggered. 
If the designated interrupt is a pseudo-interrupt, the action 
specified does not affect any real hardware interrupt but 
is instead recorded in the associated interrupt control block. 
The use of this service does not require that the user 
issuing the M:INTCON request be connected to the desig- 
nated interrupt, thus permitting inter-user interrupts. 

The M:INTCON procedure call has the form 



ARM, ENABLE' 
ARM, DISABLE 

M^TCONONU.]!!-^},,^^ 

DISABLE 
TRIGGER 



where 



INT, [*jinterrupt specifies the interrupt address. 

INT, [*]'intlbl' specifies an interrupt label. If 
indirect addressing is used, the label must be in 
EBCDIC format, right-justified in the word, and 
preceded by blanks. 

ARM, ENABLE specifies that the interrupt is to be 
armed and enabled. 

ARM, DISABLE specifies that the interrupt is to be 
armed and disabled. 



DiSARM specifies that the int'errjpf is to be disarmed. 

ENABLE specifies that the interrupt is to be enabled. 

DISABLE -specified that the'interru'pt is tobe disabled. 

.* TRlG'QER specifies that the interrupt is to be 

triggered. 

Calls generated by the M:INTCON procedure have the 
form 

CAL 1,5 fpt 

where fpt points to word of the FPT shown below. 

word 



X'23' 



Interrupt address i 

Interrupt "iabeT(TEXT format)] 

. ->l20 -■---' - 



I 2 3 I 4 5 6 7 I 8 5 10 til 12 13 14 is! 16 17 IB 17 1 20 21 22 2jlv4 r, 26 "I28 29 XI ;l 



word 1 



Code 



1 1 Ttl 5 6 Ttl 9 IC 111 12 13 14 15 1 16 17 18 nl20 21 27 23I 24 7, 26 27 1 78 29 30 3 

where the 3-bit code has the following meanings: 
001 - DISARM 

010 - ARM and ENABLE 

011 - ARM and DISABLE 

100 - ENABLE 

101 - DISABLE 

111 - TRIGGER 

condition code settings resulting from an M:INTCON CAL 
are: 

CC1 - set if the user does not have real-time 

privilege. 

CC2 - set if the designated interrupt is not cen- 

trally connected (i.e., no M:CONNECT 
or M:GJOBCON has been performed on 
the interrupt). The requested operation is 
not performed in this case. 



GENERAL INTERRUPT INHIBIT 

MMNHIBiT This service permits a program with real- 

time privilege to prevent itself from being interrupted by 
any higher priority real-time task. Note that this is a soft- 
ware (not hardware) inhibit and applies to both real and 
pseudo interrupts. 
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The M:INHIB1T procedure pall has the form: 



whe 



ON specifies that the program is not to be interrupted. 

OFF specifies that the program may be interrupted 
and is the default. 



Calls generated by the MjINHIBIT procedure have the 
form 

CAL 1,5 fpt 

where fpt points to word of the FPT shown below. 

word 



X'23' 



i 2 3 ' 4 5 6 7iH 9 10 III 12 13 14 15' 16 17 18 19120 21 22 23124 25 26 27 1 18 29 30 31 

word 1 



i 2 ft! i 6 Tta 9 10 111 17 13 14 15ll6 17 IB 19 1 20 21 22 "Im 25 26 27 1 2B 2» 30 3 

where f specifies OFF if 0; or ON if 1. 

Condition code settings resulting from an M:INHIBIT CAL 
are: 

CC1 - set if user does not have real-time privilege. 



RETURN FROM INTERRUPT PROCESSING 

MHMTRTN This service allows a mapped, scheduled 

program entered as the result of a centrally connected in- 
terrupt or elapsed clock interval to return to the point of 
interruption. The actual return is to the environment that 
existed For this program or user when the interrupt occurred 
even if this user was not in control when the interrupt oc- 
curred. The environment that is restored was saved in the 
user's TCB at the time of interrupt entry. 

The M:INTRTN procedure call has the form 



M:INTRTN 



[LEAVE 

ARM[, ENABLE] 
ARM, DISABLE 
DISARM 



where 



LEAVE specifies that the interrupt is to be left in 
its current state. LEAVE is the default for this 
procedure. 



ARM[>ENABLE] specifier that the interrupt is to be 

left a*med and enabled. (It is not necessary to 
specify ENABLE.) 

ARM, DISABtE specifies that the interrupt is to be 

ilsft armed and disabled. (It is necessary to specify 
.':■' DISABLE.) 

DISARM specifies that the interrupt is to be left 
disarmed. If DISARM is specified when exiting 
a clock-processing routine (see M:CLOCK below), 
the clock ICB is released as though the user had 
issued an M:CLOCK call with the CANCEL 
option. 

The ARM, ENABLE and ARM,DISABLE options have no 
effect when exiting a clock-processing routine. 

Calls generated by the M:INTRTN procedure have the 
form: 

CAL 1,9 X'OA' 

where the CAL instruction is as follows: 



X'04' 



0- 



■o\ 



X'OA' 



1 2 it* 56 7 I e 9 10 111 12 13 14 I5l 16 17 18 19120 21 22 23124 2; 26 2/T2e ?9 30 31 

where the 2-bit code has the following meanings: 

00 - LEAVE 

01 - DISARM 

10 - ARM and ENABLE 

1 1 - ARM and DISABLE 

When an error condition occurs, the user is aborted with an 
error code of either A301 or B802 (see Appendix B of the 
CP-V/BP Reference Manual, 90 17 64). 

QUEUE FOR INTERRUPT 

NL'QFl This service permits the user to suspend execu- 

tion while awaiting interrupts or elapsed clock intervals as- 
signed a priority higher than the current execution priority. 
If there are no interrupts connected for this user that satisfy 
this condition, the user is aborted with a code of B8 and a 
subcode of 01. 

The M:QFI procedure call has the form 

M:QF1 

Calls generated by the M:QFI procedure have the form 

CAL 1,5 fpt 
where fpt points to the FPT shown below. 



X'24' 


0- 






i 


















U 





12 3(45 


6 7 1 


e » 


to ,:ili. 


13 U 1. 


1 it 17 it i»lr, ; 


a rlu ;; 


v. i/!ii j- 
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OITAlfc HSTiBRUPT STATUS 

HfclMTSTAT The service permits any user to query the 

status of any real' or pseudo interrupt location. The format 
of the M.INTSTAT procedure call is 



M.iNTSTAT .aNT,^!^ 1 }' 



where 

INT, [*]interrupt specifies an interrupt address. 

lNT r [*3'intlbl' specifies an interrupt label. If 
indirect addressing is used, the label must be in 
EBCDIC format, right-justified in the word, and 
preceded by blanks. 

The following word of information is returned to the user in 
general register 8: 



STAT 



USER 



GJOB' 



where 

STAT indicates the status of the task associated 
with the interrupt location: 

STAT Meaning 
X'80' Task is active. 
X'40 1 Task is asleep or queued for interrupt. 
Task is waiting for I/O completion. 



X'20' 
X'10' 

X'01' 



Task is blocked and waiting for a 
resource. 

Specified interrupt is not currently 
associated with any user (i.e., 
inactive). 



USER is the user number of the user program which 
issued the M:CONNECT or M:GJOBCON. 

GJOB* is the user number of the ghost job (if it is 
active) which will be entered upon the occur- 
rence of the interrupt. If the ghost job is not 
active, GJOB* contains zero. 

T specifies that the interrupt has been triggered, 
if set to one. 

E specifies that the interrupt is enabled, if set to 
one. 

A specifies that the interrupt is armed, if set to 
one. 



Calls generated by the M:fNTSTAT procedure have the forr 

CAll,5 fpt 
where fpt points to the FPT shown below. 



X'27' 



-0 



_ Interrupt address 

Interrupt labeTjfEXT format) 



6 i 1 i'ti J 6 Hi » 16 till} i) u is' i6 17 i« iMjo ji ?? n\}t r, ?t .vlii 

Condition code settings resulting from an M:INTSTAT CAL 
are: 

CC2 - set If the specified interrupt is not currently 
associated with any user (i.e., inactive). 
(The STAT field of general register 8 is set 
to 01.) 



LOCK IN CORE SERVICE 

HfcHOLD Many real-time applications require that a 

program be held in core while various forms of special I/O 
occur. Since the CP-V scheduler will swap users as con- 
ditions require in order to keep as many executable users 
in core as possible, it is necessary for those real-time pro- 
grams which require extended core residency to identify 
themselves via the MrHOLD service. 

The format of the M:HOLD procedure call is 
M:HOLD {°£*} [, PURGE] 

where . 

ON specifies that swapping is to be prevented for 
this user (i.e., the user is to be locked in core). 

OFF releases the hold. 

PURGE specifies that the user's pages should not be 
released if the user exits (or aborts) while locked 
in core. 

Condition code settings resulting from an M:HOLD call are: 

CC1 - set if user does not have real-time privilege. 

CC2 - set if, at this time, there is not enough 
room left in core to hold the routine that 
allocates new disk space or the routine 
that communicates with the symbiont 
ghost. 

Restrictions: 

1. The user must have real-time privilege. 

2. All memory management services which increase this 
user's size and the M:LINK and M:LDTRC services will 
norV "< I lowed once the user is held in core. 
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•-- u ♦: . :.o the no f u i e • > ? M . 1 i O L D , restrictions must b e 
P'irtcce on the use of ce-toin monitor services that re- 
qu'i'^e. access to non-resident monitor routines or 
resources- .1* is possible for one or more real-time 
uses lo* acquire- arid lock -enough core to prevent 
certain system ghosts' (specifically, ALLOC AT and/or 
KBBAF) from being swapped into core. This may occur 
even if one or more of the real-time users did not 
receive the warning provided by CC2. If this does 
occur, any request by one of these real-time tasks for 
ony monitor service that requires action by the 
blocked system ghost causes the reol-time task to be 
aborted with an error code of B807. M:OPEN and 
M:CLOSE to disk files are prohibited, resulting in a 
B8-03 error. 

Because of the extremely adverse effects that improper use 
of the M.-HOLD service can have on the integrity and 
efficiency of the CP-V system, it is suggested that use of 
the M:HOLD service be restricted to those real-time pro- 
grams that absolutely must not be swapped during special 
I/O; such programs should be kept as small as is practical, 
and should refrain from issuing any standard file manage- 
ment or symbionf-stream I/O CALs while an MrHOLD is in 
effect. 

It is important to note that any program using M:HOLD 
should take exit control to cover abort conditions because 
if an abort or exit occurs while the user is locked in mem- 
ory, the memory involved will not be released if PURGE 
was specified. 

Calls generated by the M:HOLD procedure have the form 

CAL1,5 fpt 
where fpt points to the FPT shown below. 



X'25' 



i 2 3 I 4 5 6 i t 8 5 10 III 12 13 14 15I 16 17 15 >«lj0 21 22 }i\ }» 25 26 2^1 76 29 30 31 

where 

fj specifies ON if set to or OFF if set to 1. 

f 2 specifies PURGE if set to 1. 

CLOCK SERVICE 

M:CL0CK This service permits a user with a privilege 

level of 80 or higher to request entry a\ a specified address 
when a specified time interval has elapsed. The format of 
the MrCLOCK procedure call is: 

MrCLOCK (ENTRY, [*]address), 



D 



{CANCEL 

t(IN fERVAL, [*]units)[, (PRIO, [*]priority)] 






[,ONESHOTj[, MASTER]] 



/here 



ENTRY, [*]address specifies the address at which 

the user is to be given control when the specified 
interval has expired. The environment existing 



for the, user at the time of the interval expiration 
is saved in the user's TCB as described under 
MCONNECT. ';'■ 

CANCE1 . causes any outstanding M:CLOCK requests 
for the specified entry address to be canceled. 

INTERVAL, [*]units specifies the time interval in 
two-millisecond units. 

PRIO, [^priority permits users with real-time pri- 
vilege to specify the software priority. This 
option is ignored if the user does not have real- 
time privilege. 

ONESHOT cuases the MrCLOCK request to be 
automatically canceled after one occurrence. If 
ONESHOT is not specified, the interval timing is 
to be automatically repeated until CANCELed. 

MASTER specifies that the user will be given con- 
trol in the MASTER mode. (This is only honored 
if the user has real-time privilege.) The default 
is the SLAVE mode. 

Calls generated by the MrCLOCK procedure have the form 

CALl f 5 fpt 

where fpt points to word of the FPT shown below. 

word 



X'26' 



■' Entry address 



0T 2 l\* 5 6 7 18 9 10 111 12 13 14 is! « 17 II l<j 20 21 22 23 1 IX 25 26 27 1 ?8 29 30 31 

word 1 



o i 2 m si n» » to 11112 13 u 151 it 17 ie 1912c 21 22 23124 25 26 2712s 2«~» 31 
word 2 (PI) 



Timer units 



I 2 314 56 7 IS 9 10 III 12 13 14 151 16 17 IB 19120 21 22 23124 25 26 27 i 28 29 30 31 

word 3 (P2) 







Priority 



I 2 3 14 J 6 7 18 9 10 111 12 13 14 151 16 17 18 19120 21 77 23T24 25 26 27 1 78 29 30 3 

where 

M specifies MASTER mode, if set to 1. 

O specifies ONESHOT if set to 1. 

C specifies CANCEL if set to 1. 

Condition code settings resulting from an M:CLOCK CAL 
are: 

CC1 - set if no interrupt control blocks are 
available. 
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CC2 - set if CANCEL; wos S peciff 6 d and either DEVICE FREflNPTIOH SERVICES' 

(1) no interrupt control block, is associated 

with the user's entry address, or (2) the MtEEWFT KVfCf 

interrupt- control block associated with the 

user's entry address is currently active. IfcSTOPIO Certain real-time applications require that 

there be direct-control over the I/O associated with a par- 
ticular device and that there be no contention for a parti- 
cular device during certain critical processing periods. This 
CC3 - set if user does not have a privilege level includes the ability to request I/O end action off of the 

of at least 80. I/O interrupt associated with the I/O operation. 
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The real -ti me user may request that a specific device be 
preempted from use by any user other than a real-time user 
doing direct J/O to the device vM the M:STOPIO service. 
The following types of devices may not be preempted. 

Teletypes (i.e., Operator's Console) 

COC Devices 

Public RADs 

Public Disk Packs 

The format of the M:STOPIO procedure call is 

MSTOP.O {<£B. f^bo*, odr) } [f (EA( HvQdr)] 

where 

DCB, [*Jdcb adr specifies that the device associated 
with this currently open device-type DCB is to be 
preempted from use by any other user. Only the 
user requesting the STOPIO may perform subsequent 
I/O to the device. 

DEV, [*JX 'device adr 1 specifies which device is to 
be preempted from use by all but this user and is 
one of the following: 

ndd - a 12-bit physical address as used by 
Sigma hardware. 

cudd - a 14-bit physical address as used by 
Xerox 560 hardware (cluster/unit/ 
device). 

EA, Hvadr is the virtual address of a routine that is 
to handle any I/O interrupts from thedevice being 
preempted. This address is converted to a physical 
address and stored in the DCT tables. Therefore 
the user, prior to issuing the MrSTOPIO request, 
must have locked himself in core via the M:HOLD 
CAL. This routine is entered master mode, un- 
mapped, via a BAL on register 1 1 with the I/O 
interrupt active (high). Register 1 contains the 
AIO status of the interrupting device; register 2 
contains the right-justified address of the interrupt- 
ing device; byte of register 3 contains the con- 
dition codes as set by the AIO instruction; regis- 
ters 4and 5 contain the TIO status of the interrupt- 
ing device with byte of register 4containing the 
condition codes as set by the TIO instruction; 
register 6 contains the physical address of the 
(user's) end-action-receiving routine; and register 7 
contains the DCT index of the interrupting device. 
No monitor services may be requested by the re- 
ceiving routine. All registers may be considered 
volatile except register 11 through which return 
to the monitor must be made. 

The DCB form of the MrSTOPIO procedure call should be 
used whenever the user depends upon the operator to mount 



removable volumes on private spindles or tape drives. The 
DEV form should be used whenever the user wants a non- 
standard device or a symbiont-type device (e.g., LP, CR, 
CP, RBT). Use of the DEV form to preempt any other device 
type results in an abnormal return (see the condition code 
settings below). 

Calls generated by the MrSTOPIO procedure have the form 
CAL1,5 fpt 

where fpt points to word of the following FPT. 

word 



* Y"ir" 



X'lC 1 



DCB/device address 



1 2 3 I 4 5 6 7 18 9 10 111 12 13 14 IS I 16 17 IS 19120 21 22 23124 25 26 27128 29 X) 31 

word 1 







1 2 3 U 5 6 7 Is » 10 11 1 12 13 14 15116 17 18 19I2O 21 22 23I24 25 26 27I28 29 30 31 



word 2 








* 




End action address 


U 




\J 





1 2 3 1 4 5 6 


7 1 8 9 10 1 


lll2 13 14 


15116 17 18 19I2O 21 22 23I24 25 26 27I28 27 X 31 



where 



f specifies DEV if or DCB if 1. 

f 9 indicates that EA was not specified if or that 
EA was specified if 1. 

The return from the procedure call is to CAL+1 with the fol- 
lowing possible condition code settings j 

111 i 

device successfully preempted. 

1 user doesn 't have real-time privileges; or the 
physical EA address is greater than 128K 
(Xerox 560 only), 

10 requested device is not preemptable (i.e., a 
public pack or RAD), is already preempted by 
another user, the specified DCB is nonopened 
properly, or there was an illegal use of the DEV 
form. 

10 unknown device address; request ignored. 

10 requested device was associated with a sus- 
pended symbiont; request ignored. 

Should the application require that the multi-device con- 
troller (associated with the device to be preempted) also be 
preempted, the SYSCON processor should be used. This 
would imply that the application cannot tolerate any con- 
tention for either the particular device or the multi-device 
controller associated with that device (tape drive or private 
disk pack). In the case of a disk pack controller, the 
spindles associated with that controller must have been de- 
signated as private. 
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RETUBM PSE2&1PTEB DEVICE • 

M:STABTiO Any preempted I/O device may be returned 

to the system via the MrSTARTIO service. 

The format of the MrSTARTIO procedure call is 

M.STAtrrm {(DCB, Hdcb adr) "" 1 
, MrSTARTIO ( (DE ^ [*] x , device adr ,)j 

where deb adr and device adr are as described under 
MrSTOPIO. 

Calls generated by the MrSTARTIO procedure have the form 

CAL1,5 fpt 

where fpt points to word of the FPT shown below. 

word 



* X'lD' 



0- 



DCB/device address 



1 2 3 145 & 7 18 9 10 llTl2 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



word 1 



1 



Of 



1 2 314 5 6 718 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 

where f specifies DEV if or DCB if 1. 

The return from the procedure call is to CAL+1 with the fol- 
lowing possible condition code settings: 



^234 

1 
10 

10 
10 



device successfully returned. 

user doesn't have real-time privileges. 

device wasn't preempted by this user, or the 
specified DCB is not opened properly, or there 
was an illegal use of the DEV form. 

unknown device address; request ignored. 

device was busy; request ignored. 

DIRECT I/O SERVICES 

I0EX SERVICES 



The MrlOEX service is provided as one means of enabling 
the real-time user to exercise direct control over I/O op- 
erations without having to run in the master mode (see also 
the MrEXU service). The only requirements are that the 
device specified be preempted (either via the MrSTOPIO 
service or the SYSCON processor), and that an end-action 
routine be provided (either via MrSTOPIO or MrlOEX). The 
I/O functions that can be controlled via MrlOEX arer 

SIO — Start input/output. 



HI.O. •--„,! *.^!t input/output. 
TIO — Test' input/output. 
TDV — Test device. 

M:!0EX (S10). The format of the MrlOEX (SIO) procedure 

call is 

/(DCB, [*]dcb adr) 



I (DEV, Lja device adr ) J 



-(SIO, [*]clist[,REL])[,(EA, [*]vadr)] 



{/(TO,[*]value)[,(PRI,[*]prio)] 



; where 

i DCB, [*]dcb adr specifies that the I/O function is 

to be performed for the device associated with the 
currently open DCB addressed. 

DEV, [*]X'device adr 1 specifies the device for which 
the I/O function is to be performed and is one of 
the following: 

ndd —a 12-bit physical address as used by 
Sigma hardware. 

cudd —a 14-bit physical address as used by 
Xerox 560 hardware (cluster/unit/ 
device). 

SIO,[*]clist is the starting virtual address (double- 
word bound)of thel/Ocommand list to be initiated. 
All buffer addresses within the command list itself 
must be physical addresses. The channel program 
must request a "Channel End Interrupt" (unless REL 
has been specified, see below); however, multiple 
interrupts per I/O requests are permitted (e.g., 
"Zero Byte Count Interrupt" and "Channel End 
Interrupt"). 

REL specifies that the channel is to be released af- 
ter issuing the SIO. This would be used with 
command lists which do not result in data transfer 
operations (e.g., seek orders, rewind orders, head- 
positioning orders). 

EA, l*Jvadr is as described under M-.STOPIO; the 

MrHOLD requirement applies to MrlOEX also. 

TO, Rvalue is the number of 4.8 second intervals 
allowed to elapse following the issuance of the SIO 
instruction before the EA address will be entered. 
In this case, the user's EA routine is entered master 
mode, unmapped, via a BAL on register 11 with 
registers 1 and 2 equal to zero. Register 7 contains 
the DCT index and register 6 contains the physical 
address of the (user's) end-act ion-receiving routine. 
Byte of register 3 contains the condition codes as 
set by the SIO instruction; registers 4 and 5 con- 
tain the SIO status registers' information. No mon- 
itor services may be requested by the receiving 
routine. All registers may be considered volatile 
except register 1 1 through which return to the mon- 
itor must be made. A time-out value of zero 
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implies that no Hme-our facility is desired (default), 
however the user's EA address will r'fways be en- 
tered should an SIO failure occur (in this case 
register 1 v/ill be nonzero). 

PRI/ [*jprio .is the priority at "which to queue the 
request and is a value between and.X'FF. The 
default is the value of the user's current execution 
priority. 



Table 45 summarizes the various possible register settings 
for end-action routines. 

Calls generated by the M:IOEX (SIO) procedure have 
the form 

CAL.1,5 fpt 

where fpt points to word of the FPT shown below, 
word 



X'lE' 



12 3 14 5 6 7 



DCB device address 



8 9 10 11.1 12 13 14 151 16 17 18 19120 21 22 23124 25 26 27128 29 30 31 



word 1 



12 3 



word 2 



45 6 7 18 9 10 111 12 13 U 15 



16 17 18 19120 21 22 23124 25 26 27128 29 30 31 



0- Command list address 



I 2 3 U S 6 7 U 9 10 11 1 12 13 14 151 16 17 IS 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



wo rd 3 (PI) 



End-action address 



<Tl 2 3 14 5 6 7 18? 10 VI I 12 13 14 15114 17 18 IS"! 20 21 22 23124 25 26 27 US 2* 30 3! 



word 4 (P2) 







01 2 3 I 4. 5 6 7 Is 9 10 111 12 13 14 IS I 16 17 18 l»lw 21 22 23 



word 5 (P3) 



Time-out 
value 



24 25 26 27128 29 30 31 







Priority 



1 2 3 I -4 5 6 7 I 8 9 10 11112 13 14 15 1 16 17 18 19 1 20 21 22 23124 25 26 27I28 29 30 31 

where 

f 1 specifies DEV if or DCB if 1 . 

f2 is set to 1 if REL was specified on SIO. 

The return from the procedure call is to CAL+1 with the fol- 
lowing possible condition code settings: 

1 1 1 i 

I/O request successfully queued. 

1 user doesn't have real-time privileges. 

10 specified device doesn't exist or the specified 
DCB is not opened properly. 

10 EA was not specified and the DCT tables do not 
contain the address of an end-action receiver; 
or the physical address EA is greater than 128K 
(Xerox 560 only). 

10 specified device is not preempted, of has been 
preempted by another user. 



Table 45. Register Settings for End-Action Routines 



Register 


Contents when Routine Entered 
due to Interrupt 


Contents when Routine Entered due to 
Timeout or SIO Failure 


R0 


- 


- 


Rl* 


AIO status. 


= timeout; Nonzero = SIO failure. 


R2* 


Device address. 





R3 


AIO condition codes (byte 0). 


SIO condition codes (byte 0). 


R4 and 
R5 


TIO status; byte of R4 contains the 
condition codes from TIO. 


SIO status (if timeout). R4 contains the 
doubleword address of the failing channel 
program (if SIO failure). 


R6 


Physical address of EA routine. 


Physical address of EA routine. 


R7 


DCT index. 


DCT index. 


*R1 and R2 indica 


te how the end-action routine was entered. 
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M:!OEX (H1D/TI0/T0V) The format of the M:IOEX 

(HIO/TIO/TDV) procedure call is 



M : IOEX 



f(DCB, r*]dcb adr 
l(DEV, u *JX'device adr') 



r')J'" 



fHIO] 
TIC 
ITDV. 



where deb adr ond device adr are* 6s described under 
M:IOEX. 

Calls generated by the M-.IOEX (HIO/TIO/TDV) procedure 
have the form 

CAL 1,5 fpt 

where fpt points to word of the following FPT. 

word 



* YMCi 



X'lF' 



DCB/device address 



Ft 2 3 I 4 5 6 7 I 8 9 10 II 112 13 U lsl 16 17 18 wi/O 21 22 23 ! 24 25 26 27 1 28 29 30 31 



word 1 



i 2 3 U S 6 718 9 10 11112 13 14 15116 17 18 19I2O 21 22 23 1 24 25 26 27|28 29 30 31 



Code 



whe 


re 






code is: 







if TIO 




1 


if TDV 




2 


if HIO 



f specifies DEV if or DCB if 1. 

The return from the procedure call is to CAL+1 with the 
condition codes and registers set as if the user had issued 
the following instruction: 



HIO 
TIO 

ITDV. 



, 8 X'device address' 



Since the condition codes cannot be used to communicate 
abnormal conditions for any of the above three services, 
any of the abnormal conditions indicated below will result 
in a program abort (code B9, subcode as indicated). Such 
aborts may be intercepted by the user via TRAP control 
(M:TRAP procedure call specifying CAL). 

Subcode Meaning 



01 
02 



User doesn't have real-time privilege. 

iSpecified device doesn't exist, is not pre- 
empted by this user, or the specified DCB is 
not opened properly. 



EXECUTE PRIVILEGED INSTRUCTION SERVICE 

F&EXU The M:EXU service is provided as another way 

to enable the real-time user to execute I/O instructions 
and other privileged instructions without having to run in 
the master mode (see also the M:IOEX Service). The only 
requirement is thaf the instruction op code to be executed 
be one of the following: 



Op Code 


Mneumonic 


X»4C 


SIO 


X'4D' 


TIO 


X'4E' 


TDV 


X'4F' 


HIO 


X'6C 


RD 


X'6D' 


WD 



The SIO execution service is intended primarily for inter- 
facing to devices not known to the operating system (DCT 
tables) and which do not generate I/O interrupts (X'5C'). 
However, no validity checks are made and if the SIO will 
result in an I/O interrupt, it is assumed that the user will 
have provided an end-action receiver via the M:STOPIO 
service. 

For a complete discussion of the M:EXU service, see the 
CP-V/BP Reference Manual, 90 17 64. 



ENTER MASTER MODE 

MlMASTER The M:MASTER procedure allowsa user with 

sufficient privilege level (CO or higher or the MS privilege) 
to operate in the master mode (master-protected mode if 
running on a Sigma 9 or Xerox 560) with a write key of 1. 
(This procedure resides in SYSTEM BPM. ) The format of the 
procedure call is 

M:MASTER 

Calls generated by the M:MASTER procedure have the form 
CAL 1,5 fpt 

where fpt points to the FPT shown below. 



X'08' 



2 3 14 5 6 7 



-0 

8 9 10 11112 13 14 15ll6 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



If the caller's privilege level is not sufficient, return is to 
CAL+1 with CC1 set. 



ENTER SLAVE MODE 

MiSLAVE The M-.SLAVE procedure allows any master 

(and master-protected) mode program to return to the slave 
mode. (This procedure resides in SYSTEM BPM.) The for- 
mat of the procedure call is 

M:SLAVE 



T36i Diietf ,1/Q ServToes 



Culis generated by the M:SLAV£ procedure have the form 
CAL1,5 fpt 

PSECT DIRECTIVE 

The Meta-Symbol PSECT directive specifies that the control 
section which follows is to begin on a page boundary. The 
directive can be useful for controlling the placement of I/O 
buffers, data, and end-action-receiving routines which will 
be accessed unmapped. 

VIRTUAL/PHYSICAL ADDRESS CONVERSION 

M:MAP The M:MAP procedure converts a specified 

virtual address to a physical address or a specified physical 
address to a virtual address. The converted address is stored 
in general register 8. The M:MAP procedure call has the 
form: 



M:MAP{^}, (ADR, [*]address) 



where 

VTP specifies virtual to physical address conversion. 

PTV • specifies physical to virtual address conversion. 

ADR, *]address specifies the location of the ad- 
> dress to be converted. 

M:MAP should be used with MrHOLD since the address 
returned via M:MAP may not be valid if a swap occurs. 

Calls generated by the M:MAP procedure have the form 
CAL1,6 fpt 

where fpt points to word of the FPT shown below. 

word 



X'02' 



Address 



1 3 3 U 5 6 7 11 « 10 111 12 13 U 13 1 14 17 It I? 1 30 2f 22 23 1 24 15 26 77 1 28 29 X 31 

word 1 



I 2 3 14 5 6 7 11 9 10 II ! 12 13 U 151 16 17 18 19 20 21 22 23124 25 26 27128 29 30 31 

where f indicates virtual to physical address conversion 
(f = 0) or physical to virtual address conversion (f = 1). 

If the user's privilege level is not at least AO, the return is 
toCAL+1 with CO set. 



MISCELLANEOUS REAL-TIME SERVICES 

The following is a set of services provided to master mode, 
mapped or unmapped real-time programs. These services 



are provided via .Meta- Symbol procedure references that 
result in BAL linkages to monitor routines (hence the master 
mode requirement), as opposed to CALL linkages. The rou- 
tines entry points are REFed as a result of the various pro- 
cedure calls/ .therefore, the program must be loaded with 
reference to the MONSTjK or Jl files in order to satisfy 
these external references. All user registers ore preserved 
by pushing them into TSTACK except as indicated for 
specific services. 



GET OR FREE PHYSICAL PAGE 

MlGPP The M:GPP procedure acquires a physical page 

of memory. The procedure call has the format 

M : GPP 

On return from the procedure, general register 3 contains 
the physical page number of the newly allocated page of 
memory or the value zero if none was available. 

In order for a mapped user to reference a physical page 
acquired by M:GPP, it is necessary to perform a Change 
Virtual Map (M:CVM) specifying the physical address of 
the page acquired by M:GPP and the virtual address into 
which this page is to be mapped. 



M:FPP The M:FPP procedure releases a physical page 

of memory that was acquired by M:GPP. The procedure 
call has the format 

M:FPP[*]poge 

where page specifies the physical page number of a page of 
memory which is to be returned to the system. 

It is the user's responsibility toreturnany pages obtained via 
M:GPP since the system keeps no record of this transaction. 



INITIATE GHOST JOB 

M:GJ0B The M:GJOB procedure activates (or awakens) 

a program as a ghost job. The format of the procedure is 

MtGJOB (LMN,!oc)[,(ACN,loc)][,(PRI,(*lvalue)][, status] 
where 

LMNJoc specifies the location containing the name 
of the program to be activated (or awakened) as a 
ghost job. The name must be in TEXTC format and 
must not be greater than 7 characters in length. If 
the name is less than four characters, a word of 
blanks (X'40's) must immediately follow the name. 

ACN, loc specifies the location containing the name 
of the account in which the program exists. The 
account name must be in TEXT format, loft-justified 
with trailing blanks to occupy two words. The 
default is the :SYS account. 
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-- PRi/1* jvuhie oeeifies the 'execution priority to be 

ossQciqted with she ghost job. The default priority 
wilf.be that defined for ghost jobs at SYSGEN. 

STATUS specifies- that all registers wiii not be - 

saved, and on return, CO is set :.if if was not • 
possible to initiate the specified; ghost'at'fhis • 
time because either ghost" job table *pace was not . 
available or user table, space was- not available,. 
If STATUS is not specified, no' information is 
returned, but the registers are saved. CO and 
CC3 are set if the specified ghost was currently 
running. CC2 is set if the specified ghost job was 
asleep or queued for interrupt and was awakened. 
Otherwise, the condition codes are all set to 
zero. 

The MrGJOB procedure returns to the calling program with 
interrupts inhibited. The calling program should immedi- 
ately clear the interrupt inhibits (with a "WD,0 X'27"' 
instruction) unless there is a pressing reason for continuing 
to run in inhibited mode. 

GET AND RELEASE DISK GRANULE 

M:G0G The M:GDG procedure dynamically acquires 

a disk granule. The procedure has the format 

M:GDG 

The starting disk address of the acquired granule is returned 
to the user in general register 8 in the following format 



E1E2 



DCTX 



RSN 



i 2 ^ + 4 ? * 7 le » 10 llllj 13 K 15116 )7 18 l?l» 21 22 ti\lA 25 26 2?\li X 30 31 

The disk address shown above is in standard format for disk 
addresses in CP-V, where: 

.El is the extension bit necessary to represent a 

17-bit relative sector number on large capacity 
disk packs. 

E2 is the extension bit necessary to represent an 
18-bit relative sector number. 

DCTX is the DCT index for the device. 

RSN !s the 16-bit relative sector number. 

If no granule is available, register 8 is set to zero. 
To load or store a DCT index, use 
j STDCTX J/ r [*Jloc| , indexj 

where 

r is the register to be loaded (stored). 

loc is a location, or optionally, a pointer to a 

location, containing (destined to contain) the 
disk address (see index below). 



inde* t-^ .. is an index regi&ter containing a word dis- 
,~ ; ; placement which, when added to the address 

given* by loc, yj'elds an effective address contain- 
4 ^Jl& (destined to contain) the disk address. 

.■ .• * u 1 -"'■'■ • I 

fa load br store a relative sector numbei: 

■ 'JLSECTA \ ,, 

(sTSECTA)'° ddregre9 

where 

oddreg is the odd numbered legister to be loaded 
or stored. (Register 15 may not be specified.) 

reg is any register except the one selected for 

'oddreg' or 15. 

Note that it is the user's responsibility to return any gran- 
ules obtained via M:GDG since the system keeps no record 
of this transaction. 

M:RDG The M:RDG procedure dynamically releases a 

granule acquired via M:GDG. The procedure has the format 

M:RDG [*]disk address 

where disk address is the starting address of the disk granule 
to be returned to the system. It must have the same format 
as described for M:GDG. 

Under certain conditions, the monitor may not- be able to 
accept a granule from the user at a particular time. In this 
case, register 8 will contain a zero indicating that the user 
must try again. * 

REPORT USER EVENT 

M'.RUE The M:RUE procedure reports an event on a 

particular user (i.e., it simulates that the event took place 
for the user). The format of the procedure call is 



M:RUE (UN,L*juser#),(EV, {!^}) 



where 



user* is the number of the user for whom the event 
is to be reported. A user may determine his own 
user number (for purposes of communicating this 
to other programs) by referencing the monitor cell 
S:CUN (Current User Number) which is located in 
page of the monitor and is therefore available 
to any user program loaded with MONSTK. 

event is one of the following symbols signifying the 
event to be reported on the user: 



Symbol 


Event 


Resulting Action 


E.CBK 
E:OFF 


BREAK 
Log -off 


Control passes to the user at 
the address specified via an 
M:1NT procedure call. 

The user is deleted from the 
system. 
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Symbol 


Event 


Resulting Action 


E:ERR 


Error 


The user is .error ed and de<-* 
leTedrff^m the system v 


E-.WU 


Wake-up 


The specified user is"scr)t;duled 
for execution and reentered * 
at the instruction following , 
the M:WAIT CALL 


E:UQA 


Unqueue 

for 

access 


The specified user is scheduled 
for execution and reentered 
at the instruction following 
the CAL1 which caused him 
to be queued for access. 



loc2 is a word location containing the value as- 
sociated with the event symbol (defined by the 
assembly SYSTEM). 

Note; Care must be taken to ensure that the user for whom 
the event is being reported is in the appropriate 
state since an illegal current state/event combi- 
nation will cause the system to crash. E:CBK, 
E:OFF, and E:ERR may be safely reported on a user 
at any point in time. 



CHECK INTERRUPT STATUS 

MsCHKINT The M:CHKINT procedure checks the status 

of an interrupt. The format of the procedure call is: 

M:CHK1NT (INT,[*]int) 

where int is the location of a word containing the address 
of the interrupt to be checked. 

The following word of information will be returned to the 
user in general register 8: 



STAT 



USER 



GJOB# 



6 i 2 3 \i i 6 7 18 9 10 11 1 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 vltt » 30 31 



where 
A 

E 

T 



specifies, if set, that the interrupt is armed. 

specifies, if set, that the interrupt is enabled. 

specifies, if set, that the interrupt has been 
triggered and the interrupt processing routine has 
not yet finished. 

STAT indicates the status of the task associated 
with the interrupt location as follows: 

STAT Meaning 

X'80' Task is active. 

X'40 1 Task is asleep or queued for interrupt. 



STAT Meaning 

X'20 1 ,' Task is waiting for I/O completion. 

X'lO 1 Task is blocked, waiting for a resource. 

X'Ol' Specified interrupt is not currently asso- 
ciated with any user (i.e., inactive). 

USER ' *; is the Internal user table index for the user 
currently associated with this interrupt. 

GJOB"* is the user number of the ghost job (if it is 

active) which will be entered on the occurrence 
of the interrupt. If the ghost job is not active, 
GJOB* contains zero. 

I/O SERVICES 

The following services resultinBAL linkages to the monitor's 
I/O Supervisor module (IOQ). They are separated into 
three types: 

1. I/O without a DCB where the user supplies the channel 
program (M:EXCP). This should be used only where no 
handler exists for a particular device or the user re- 
quires unusual control over the device. 

2. I/O without a DCB while not requiring the user to build 
his own channel program (M:NEWQ). 

3. I/O with parameters supplied ina pseudo DCB (M:QUE). 

Special problems exist when applying these techniques to 
disk I/O. Unless the volume is being managed entirely by 
the user, the user must be aware of the physical location 
of the data on the disk volume (or volumes). A random file 
would be the most common way of allocating space on a 
public or private volume for use by both privileged and non- 
privileged users. A random file is allocated contiguously 
on a public or private volume when it is opened. By speci- 
fying the FPARAM option on the M.-OPEN call to an exist- 
ing file, the user requests the monitor to pass the file attri- 
bute (FIT table) parameters to a specified location (see the 
DCB discussion in Appendix A of the CP-V/BP Reference 
Manual, 90 17 64). FDA (First Disk Address) is returned in 
word one of the X'OC — coded FIT entry. File size (in 
granules) is given in word one of the X'OD 1 — coded FIT 
entry. 

Flawed tracks are automatically taken care of by the I/O 
system assuming that the requested byte count does not cause 
the transfer to cross a track boundary from a good track to 
a flawed track. If the user ensures that all tracks are good, 
the hardware will automatically handle the case in which a 
track boundary is crossed. However, the user must handle 
the cylinder overflow condition himself. (A new seek must 
be issued between accessing the last sector of one cylinder 
and the first sector of the next cylinder. ) 



CALCULATING PHYSICAL ADDRESSES 

All of the I/O procedure calls described below are avail- 
able to the mapped or unmapped user. Several require that 
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physical addresses by passed. For all mapped users, the 
user may convert a virtual address to a physical address by 
using the M:MAP. piocedure call described previously. 

In order to ensure that a mapped user is not swapped between 
the time that the physical address is calculated and the 
time the I/O is requested, the M-.HOID (Lock in Core) 
service should Be performed. 

Note, however, that a mapped, master mode program is 
assured of not being swapped as long as it does not request 
any monitor services via CALls. 



EXECUTE CHANNEL PROGRAM 

MlEXCP The M:EXCP procedure causes the user's own 

channel program to be executed. The format of the pro- 
cedure call is 



M:EXCP (CPA,{^ loc) }),(DCT, [*] index)- 



c 



[,(PRI, [*]priority)][,(EA,[*]loc 



cz 



[,Heai])][,aOI,[*]value)] 



where 



DA(loc) specifies the physical doubleword address 

pf the start of the channel program. 

*loc specifies the word address of a word which 
contains the physical doubleword address of the 
start of the channel program. (The asterisk is 
required.) 

DCT, [*] index is the DCT index of the device 
associated with the channel program. 

PRI, [*]priority is the priority to be associated 

with the requested I/O operation. Priority re- 
quests range from to X'FF' (highest to lowest). 
Priorities in the range of to X'BF' are treated 
as real-time priority requests; X'CO' to X'FF' are 
treated as background priority requests. The only 
system I/O that operates at a real-time priority 
is swapping I/O (priority = X'10'). The default 
priority is X'FF'. 

EA, [*]loc is the physical address of the user's 

end-action routine. 

eai is a word of end-action information. This 
information is passed back to the user's end-action 
routine. 

TOI, [*Jvalue is a time-out value specified in 

five second increments. The default value is 
five seconds. 



The user's end --action routine, (if specified) is entered 
unmapped, via a BAL on register 11. All registers may be 
considered volatile (except register 11,; through which re- 
turn is made to the monitor). The following information is 
passed to the end-action routine: 



Register 


Bit Fields 


Contents 


7 


24,8 


-,DCT 


12 


8,8,16 


TYC, -, RBC 


13 


16,16 


-,CCA 


14 


32 


EAI 


15 


13, 19 


-,BUF 


where 






DCT 


is the DCT index. 





TYC is the type of completion code returned by 
the device handler. 

RBC is the remaining byte count. 

CCA is the current IOP command address. 

EAI is the end-action information specified in the 
procedure call. 

BUF is the doubleword address of the start of the 

channel program command list specified by the 
M:EXCPcall. 

The end-action routine may obtain the complete TDV status 
by referencing the doubleword table DCT13 using the DCT 
index in register 7. 

CALL NEWQ 

.M:NEWQ The MrNEWQ procedure requests I/O to be 

performed without a DCB and without a user-built channel 
program. The format of the procedure call is 



M:NEWQ [{^jl (FC, [*]code), 



L7 



< BUF 'f^oc° C) } ) ' (SIZ 'W value); - 



c 



f, (DA, * disk address l r /DI m . . .-, 
I (DCT, [*]index) J L'( PRI a*Jp"onty)];- 



"[,(NRT, [*]valuej],[,(EA, [*]loc J, [*]eai]fl 



where 



W/NW is the WAIT/NO-WAIT option. The un- 
mapped user always does I/O with NO-WAIT. This 
implies that the unmapped user should always (ex- 
cept for unusual cases) specify an end-action ad- 
dress in order to ascertain when the I/O has com- 
pleted. The mapped user will do I/O with WAIT 
unless otherwise specified by the procedure call. 
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FC, [*]code is the function code which defines (to 
the device handjer) the type oM/O operation to 
be performed. See discussion' of function codes 
below. 



BUF,BA(loc) specifies the byte address of the 
user's buffer to be used in this I/O operation. 

| BUF, *loc specifies the word address of a word which 
contains the byte address of the user's buffer. 

SIZ, [*Jvalue is the byte count to be used in this 

I/O operation. (The byte count for mapped pro- 
grams should not exceed 32K bytes (X*8006')). 

DA, *disk address specifies, for random -a ccess- 
device operations only, the address of the word 
containing the disk address to be used in this I/O 
operation. Disk addresses are of the format de- 
scribed under the discussion of the M:GDG pro- 
cedure call. 

DCT, [*]index specifies for non-random-access- 
device operations only, the DCT index of the 
device to be used in this I/O operation. 

PRI, [*]priority is the priority to be associated with 
the requested I/O operation. See the description 
of priority under the discussion of M:EXCP. 

NRT, [*]value is the number of recovery tries to 
attempt before declaring an error. 

EA, [*]loc is the physical address, or optionally a 
pointer to a location containing the physical 
address, of the user's end-action routine. 

eai is a word of end-action information. See the 
end-action description under the discussion of the 
M:EXCP procedure call. The only difference is 
that BUF is the byte-address of the user's buffer 
as supplied by the M:NEWQ procedure call. 

To assist the user in determining the correct function codes 
to be used with the M:NEWQ procedure calls, the follow- 
ing is a discussion describing the function codes of the ex- 
isting device handlers in the system. 



Typewriter Handler. The typewriter handler accepts the 
following function codes: 

- read with editing 

1 - write 

2 - write with device name 

3 - read without editing 

4 - read with editing and retry 

5 - write new line character 

6 - write with device name tabbed 



R AD Handier. The RAD handler accepts the following 
function codes: 

- seek-read 
T - seek^write 

2 - sense 

3 - seek-check write. 

4 - seek-write, seek-checkwrite 

Error recovery on the RAD generally amounts to redoing the 
same operation when an error has been detected. One ex- 
ception is v/hen a checkwrite is being performed fora write 
and an error is indicated. In this case, the write is done 
over, followed by another checkwrite. Checkwrites are 
performed for all writes if sense switch 1 is set on the op- 
erator's console. Special conditions checked for are write 
violation and illegal seek address. 



9-Track Tape Handler. The 9-track tape handler accepts 
the following function codes: 

- read 

1 - write 

2 - read reverse 

3 - write tape mark 

4 - backspace record 

5 - forwardspace record 

6 - backspace file 

7 - forwardspace file 

8 - rewind 

9 - sense 

10 - correctable read recovery 

1 1 - noncorrectable read recovery 

12 - write recovery 

13 - correctable read reverse recovery 

14 - noncorrectable read reverse recovery 

15 - write tape mark recovery 

7-Track Tape Handler. The 7-track tape handler accepts 
the following function codes: 

- read packed 

1 - write packed 

2 - read reverse packed 

3 - write tape mark 

4 - backspace record 

5 - forwardspace record 

6 - backspace file 

7 - forwardspace file 

8 - rewind 

9 - read binary 

10 - write binary 

1 1 - read reverse binary 

12 - read decimal 

13 - write decimal 

14 - read reverse decimal 

15 - read packed recovery 

16 - write packed recovery 

17 - write tape mark recovery 

18 - read binary recovery 

19 - write binary recovery 
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20 - read decimal recovery 

21 - write decimal recovery 

22 - final backspace record for reverse read 

23 - fihaibactcspqce record if unrecoverable error 



Card Reader Handler. The card reader handier accepts 



Appendix A oi .ne CP-V/BP Reference Manual, 90 17 64. ) 
The format of the M:QUE procedure call is 



M:QUE [*]dcb, (FC,[*]code)[,(EA, [*]loc[, [*]eai])] 



where 



the following function codes: 

- read binary 
2 - read automatic 



Line Printer Handler. The line printer handler accepts 
the following function codes: 

1 - write without format 
3 - write with format 



Paper Tape Handler (PTAP). The paper tape handler ac- 
cepts the following function codes: 

- read automatic 

1 - write BCD 

2 - read count 

3 - write binary 

4 - read direct 

5 - write direct 

6 - read BCD 

7 -read binary 



Card Punch Handlers. The card punch handlers accept the 
following function codes: 

- punch BCD 

1 - punch binary 



Disk Pack Handler (DPAK). The disk pack handler uses the 
following function codes: 

- seek-read 

1 - seek-write 

2 - sense 

3 - seek-checkwrite 

4 - read 

5 - write 

6 - checkwrite 

7 - restore 

8 - seek-read header 

9 - read header 



CALL QUE 

M'.QUE The M:QUE procedure requests that I/O be 

performed through parameters supplied in a specified DCB. 
At the time of the call, the specified DCB need only be 
9 words in length but must contain valid information in the 
following fields: NRT, QBUF, BLK, and CDA. (See 



deb specifies the DCB associated with the re- 
quested I/O operation. 

code is an 8-bit code (described in Figure ^be- 
low) which defines (to the device handler) the 
type of I/O operation to be performed. The code 
may be expressed as a decimal number or as a 
hexadecimal number in the format X'dd'. 

loc and eai function exactly as described under 
the discussion of the M:EXCP procedure call. 
The user's end-action routine (if specified) will 
be entered unmapped via a BAL on register 11 
after the TYC (type of completion code) and ARS 
(actual record size) have been entered into the 
DCB. The following information is passed to the 
end-action routine. 



Register 

6 

7 

8 

14 

where 



Bit Fields 

15, 17 
24,8 
8,7,17 
32 



Contents 

-,BUF 
-,DCT 
FC, -, DCB 
EAI 



BUF is the word address of the user's buf- 
fer associated with this I/O request 

DCT is the DCT index as specified in the 
CDA field of the DCB at the time of the 
M-.QUE procedure call. 

FC, DCB, and EAI are as specified in the 
M:QUE procedure call. 

For the unmapped user, the I/O will be queued at a priority 
of X'FF'. For the mapped user, the I/O will be queued 
based upon the user's current execution priority. 





1 2 3,4 


7 









DIR 


PACK 


FBCD 


Code 




V 


/here 






Code has the following meanings: 




- read BCD 




1 - read direct BCD 




2 - read binary 





Figure 17. I/O Operation Codes for Device 
Handler (M:QUE) 
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3 - read direct bincry 


4 - write BCD 


5 - write direct BCD 


6 - write binary (write and format) 


7 - write direct binary 


A - skip record forward 




B - skip record reverse 




C - skip file forward 
D - skip file reverse 
E - rewind 


bits 1-3 are 
ignored for 
these codes 


F - write end-of-file 




FBCD specifies no FORTRAN conversions 
' if or FORTRAN conversions if 1. 


D1R specifies forward direction if or re- 
verse direction if 1. 


If the device is not 91, 71, or Ml, only bits 5 
through 7 are meaningful. 



Figure 17. I/O Operation Codes for Device 
Handler (M:QUE) (cont. ) 



SEND CHARACTER TO TERMINAL 

M:COC The M:COC procedure sends a character to a 

user terminal. 



*^C[fc9'»**{£ff3> 



where 



user* is the user number of the user whose terminal 
is to receive the character. 

line* is the line number of the terminal which is 

to receive the character. 

'character* is the EBCDIC character to be sent to 
' the specified terminal. 

*loc[, ireg] specifies the address of a location 
which contains the character to be sent to the 
terminal (loc). (The asterisk is required but does 
not indicate indirectness.) The ireg field specifies 
an index register which contains the byte displace- 
ment which, when added to the address specified 
by loc, will yield the byte address of the char- 
acter to be sent to the terminal. If ireg is absent, 
loc is assumed to contain the left-justified char- 
acter to be sent to the terminal. 



DYNAMIC PHYSICAL PASE ALLOCATION. 
' FOR REAL-TIME PROCESSING' 

HSTRODUCTiO&i 

Physical pages are made available for real-time processing 
in either of two ways: 

• Dedication of physical core pages at boot-time. These 
pages are known as the Resident Foreground (RESDF) 
pages. SYSGEN parameters define the physical pagej 
that are to be removed from the system and dedicated 
to real-time processing. These pages remain dedi- 
cated real-time pages until returned to the system via 
the Physical Page Stealer (PPS) Ghost. 

• Dynamic acquisition and release of physical core pages 
during normal operations. These pages are known as 
the Dynamic Resident Foreground (DYNRESDF) pages. 
The operator can acquire or release DYNRESDF pages 
by communicating with the Physical Page Stealer (PPS) 
ghost job. 

In both cases, foreground memory is allocated in 'memory 
segments'. A memory segment in this context is simply a 
set of contiguous physical pages. There is only one RESDF 
memory segment (i.e., that which may be allocated at 
boot-time). There may be several DYNRESDF memory 
segments, the maximum number of which is specified at 
SYSGEN time. All real-time memory segments must be 
allocated in the area between 64K and the end of physical 
core. 

The operator, by communicating with the Physical Page 
Stealer ghost job, has control over the allocation of both 
RESDF and DYNRESDF pages. The operator also has the 
ability to reset the SYSGEN defined RESDF size and maxi- 
mum DYNRESDF size thus affecting the system's maximum 
user size. Increases to RESDF size or to maximum DYN- 
RESDF size cause a decrease of the maximum user size; 
decreases to RESDF size or the DYNRESDF size cause the 
maximum user size to be increased. By setting the maxi- 
mum number of real-time pages that may be allocated to a 
minimum, the operator is able to allow very large jobs to 
be scheduled. Decreases to the maximum real-time page 
values may be effected at any time. Increases that would 
cause the maximum user size to be set to less than 186 pages 
are limited to times when there are no users on the system 
other than system ghosts; i.e., the system must be quiescent 
except for ALLOCAT, RBBAT, FILL and the PPS ghosts. 
Neither RESDF nor DYNRESDF maximum size may be in- 
creased to the point where the maximum user size is too small 
to allow the system ghosts to run. 



SYSGEN CONSIDERATIONS 

The system parameters that define the pages to be allo- 
cated at boot-time, the maximum number of pages that may 
be dedicated for real-time use, and the maximum number 
of memory segments that may be allocated for real-time 
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processing may be specified via options, of the :F.RGD 
command of PASS2. The format of theSef options is as 
fol lows: 

(RESDF, size, address) 

where 

size specifies, in decimal, number of pages, the 

default size of the dedicated foreground memory 
area to be allocated at system initialization. 

address specifies, in hexadecimal, the word ad- 

dress of the first page in the RESDF memory seg- 
ment. This value must be equal to or greater 
than I0,000| o . 

Both size and address may be overridden by the operator at 
system initialization. Both parameters may be reset via 
communication with the Physical Page Stealer ghost job. 

(DYNRESDF, pages, segments) 

where 

pages specifies in decimal the maximum number of 
pages that may be dynamically allocated for fore- 
ground use. These pages are not removed from 
the system until requested, but the maximum user 
size is reduced by the value specified. This value 
may be altered by the operator via the PPS ghost. 

segments specifies in decimal the maximum number 
of dedicated real-time memory segments that may 
be allocated for foreground use. The default 
value is one. 



INITIALIZATION 

When a real-time system is booted from a system tape and 
operator console interaction is requested, or when a real- 
time system is booted from the system RAD, the following 
message is output on the OC device: 



RESET RESDF YYY,XXXXX? 



This allows the operator to override the SYSGEN-defined 
values for the beginning of the RESDF area and/or the size 
of the RESDF area. The operator should respond as follows: 



where 



<]© 



yyy is the number of pages in decimal to be in the 
RESDF area. A value of through 999 may be 
used. 

xxxxx is the word address in hexadecimal of the 
first page in the RESDF area. A value greater 
than 10,000| 6 (64K) must be used. 



Either value may be omitted, or a response of NEW LINE 
alone may be used to request the. SYSGEN-defined default 
far .the omitted value(s). 



THE PHYSICAL PAGE STEALER GHOST JOB (PPS) 

The Physical Page Stealer ghost job is used for the manage- 
ment of all dedicated foreground memory. It is loaded for 
execution via the following keyin: 

IGJOB PPS 

PPS then asks the operator for a command: 



id:(PPS) 



The operator may respond with one of the following commands: 

Dl[SPLAYj Display memory segments cuuently 
allocated. 

GE[T] yyy, xxxxx Get DYNRESDF pages. 

FR[EE] yyy, xxxxx Free DYNRESDF pages. 

DY[NRESDF] yyy Reset maximum number of DYN- 
RESDF pages. 

RE[SDF] [yyy][, xxxxx] Redefine the RESDF area. 

EN[d] Exit ghost job. 



wher 



yyy specifies in decimal the number of pages. 

xxxxx specifies the word address in hexadecimal 
of the first page in the real-time memory seg- 
ment. This value must be equal to or greater 
than 10,000 16 . 

PPS will attempt to perform the requested function, type 
an error message if the function cannot be performed, and 
reprompf the operator to get the next command. The END 
command is used to terminate PPS processing. 

If the format of the command is in error, such as missing 
parometers, bad delimiters, etc., PPS will type 'EH??* 
and reprompt the operator to reenter the command. 

The following message will be displayed if the number of 
pages specified is in error: 



EXPRESS ' OF PAGES IN DECIMAL 0-999 
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The following message wi 1 1 be displayed if the pago address 
specified is in error; '.'■.' 



iKPRESS PG ADDR IN HEX 10,000-xxxxx 



where xxxxx is the word address of the last page of 
physical core. 

If the version of :MONSTK with which PPS was loaded does 
not correspond to the :MONSTK of the running system, the 
following message will be displayed: 



LOADED WITH WRONG .MONSTK 



Since the operator is the only one who is allowed to com- 
municate with the PPS ghost, running PPS is not allowed 
From on-line or batch. If attempting to run PPS other than 
as a ghost job, the following message will be typed: 



PPS MUST BE EXECUTED AS A GHOST JOB 



The PPS commands are described in detail in the following 
paragraphs. 

DISPLAY The DISPLAY command is used to obtain 

Information concerning allocated real-time pages and the 
current settings of system parameters that define the maxi- 
mum real-time pages allocation. • 

i 

The following information is output on the OC device: 

MAX DYNRESDF = yyy 
CURRENT DYNRESDF = yyy 
DYNRESDF SEGMENT yyy xxxxx 
RESDF SEGMENT yyy xxxxx 
MAXIMUM USER CORE = yyy 

where 

yyy is the decimal number of pages. 

xxxxx is the hexadecimal word address of the first 
page in the real-time memory segment. 

The DYNRESDF SEGMENT message is repeated for each 
currently allocated DYNRESDF memory segment. 

GET The GET command is used to a I locate DYNRESDF 

pages. This command may be used at any time and has no 
effect on the maximum user size. The format of the 
command is 

GE[f} yyy, xxxxx 
where 

yyy specifies in decimal the number of pages. 

xxxxx specifies the word address in hexadeci- 
mal of the first page in the real-time memory 
segment. This value must be equal to or greater 
than 10,000. 



The PPS ghost first validates that it is valid to allocate 
DYNRESDF pages. If the maximum number of DYNRESDF 
segments has already been allocated, the following mes- 
sage is displayed: . 



MAXIMUM DYNRESDF SEGMENTS ALLOCATED 



If the allocation of the DYNRESDF memory segment would 
cause the number of DYNRESDF pages to exceed the maxi- 
mum allowed, the following message is displayed: 



EXCEEDS DYNRESDF 



The PPS ghost then validates that the pages specified are 
available. If the pages are currently being used by the 
monitor, (i.e., for transaction processing), the following 
message is typed: 



PAGES IN USE BY MONITOR 



If some or all of the pages specified are allocated as RESDF 
or DYNRESDF pages, the following message is typed: 



PAGES ARE REAL TIME PAGES 



The DISPLAY command should be used to determine the 
current allocation of real-time memory segments. 

If the pages cannot be obtained for any other reason, the 
following message is typed: 



UNABLE TO OBTAIN PAGES 



Otherwise, the pages specified are removed from the system 
and the operator is prompted to enter the next command. 

FREE The FREE command is used to return currently 
allocated DYNRESDF pages to the system. This command 
may be used at any time and has no effect on the maximum 
user size. 

The format of the command is 
FR[EEj yyy, xxxxx 



where 



yyy specifies the number of pages in decimal. 

xxxxx specifies the word address in hexadecimal of 
the first page in the teal -time memory segment. This 
value must be equal to or greater than 10,000... 
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DYNRESDF memory segments cannot be partially released. 
That i&, -alLpages 'within the memory segment must be 
released w'rffa 6ne FREE command. If the pages specified 
are not totally contained in one memory" segment, or' the 
entire memory segment was not specified, the following 
message is displayed: 



NOT A DYNRESDF MEMORY SEGMEKm 



The display command should be used to determine the 
currently allocated DYNRESDF segments. 

If the segment specified is valid, the pages will be returned 
to the system and the operator will be prompted to enter 
the next command. 

DYNRESDF The DYNRESDF command is used to re- 

define the maximum number of pages that may be removed 
from the system to be used as dynamic RESDF pages. No 
pages are obtained or released as a result of this command. 
This command alters the maximum user size. 

The format of the command is 
DYfNRESDF] yyy 

where yyy specifies the number of pages in decimal. 

The value specified is compared to the current setting of 
maximum number of DYNRESDF pages. If attempting to 
increase the maximum size, the system must have no users 
other than system ghosts. If other users are on the system, 
the following message is typed: 



SYSTEM IS ACTIVE - NO CAN DO 



The maximum user size will be decreased by an amount 
equal to the increase in maximum DYNRESDF pages. PPS 
checks to determine that the system ghosts would be able 
to tolerate the decrease in user size. If not, the following 
message is displayed: 



REQUEST WOULD LOCK OUT SYSTEM GHOSTS 



Otherwise, the maximum number of DYNRESDF pages that 
may be allocated is reset as specified and the maximum 
user size is decreased by the amount of increase to maxi- 
mum DYNRESDF pages. 

If attempting to decrease the maximum number of DYNRESDF 
pages and the maximum user size would fall below 186 pages, 
the value specified must be equal to or greater than the 
number of DYNRESDF pages currently allocated. If not, 
the following message is displayed: 



CURRENT DYNRESDF PAGES > NEW MAXIMUM 



Otherwise, the maximum number of DYNRESDF pages that 
may be allocated is reset as specified and the maximum 
user size is increased by the amount of decrease to maxi- 
mum DYNRESDF pages. 



RESDF The RESDF command is used to redefine the 

RESDF memory segment. The RESDF command may be used 
to release all RESDF pages to the system or to obtain RESDF 
pages. 

The format of the command is 
RE[SDF][yyy][, xxxxx] 

where 

yyy specifies the number of pages in decimal. 

xxxxx specifies the word address in hexadecimal 
of the first page in the real-time memory seg- 
ment. This value must be equal to or greatei 
than 10000... 

To release all RESDF pages, the following format should be 
used: 

RESDF 

This will cause all RESDF pages to be returned to the sys- 
tem. The maximum user size will be increased by the 
RESDF size. 

If the RESDF memory segment is not cuirently allocated 
when this format of the RESDF command is used, the fol- 
lowing message is displayed: 



NO RESDF PAGES ALLOCATED 



To re-establish the RESDF memory segment, the following 
format of the command should be used: 

RESDF [yyy] j_, xxxxx] 

If either the number of pages or the word address of the 
first pageisnot specified, the previous value of the paiam- 
eter is used. 

If the RESDF segment is currently allocated, the following 
message is typed: 



RESDF PAGES ALREADY ALLOCATED 



When this format of the RESDF command is used, the max- 
imum user size will be decreased by an amount equal to 
the size of the RESDF segment to be allocated. There- 
fore, if the maximum user size would fall below 186 pages, 
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there must be no users on the system other than system 
ghosts and the system ghosts must be able to tolerate the 
decreased user size. Checks are also made to determine 
if the pages specified are available as described under the 
discussion of the GET command. 

Otherwise, the pages specified are removed from, the 
system and the maximum user size is decreased byv an 
amount equal to the number of pages in the RES DF memory 
segment. 



END The END command terminates PPS processing and 

has the format 



EN[D] 



MONITOR DEFs 

The following words are DEFed in the monitor root and may 
be used by the real-time programmer to gain information 
concerning the current allocation of real-time pages. 

RESDF The size of the RESDF area currently 

allocated. If all RESDF pages have 
been returned to the system, the 
value is zero. 

RESDFP jThe word address of the first page in 

the RESDF area. 

DYNRESDF The number of DYNRESDF pages 

currently allocated. 

MDYNRESDF The maximum number of DYNRESDF 
pages that may be allocated. 

PPrUPPC The total number of RESDF and 

DYNRESDF pages currently a I located. 



I 8ESBF MEMORY CAL 

The real-time user may obtain information from the monitor 
concerning, the current -allocation of rcal-tiiineymejrvory 
segments by issuing the following CAL: 

CAU,5 fpt 

where fpt points to word of the FPT shown below. 

word 



X'lB' 



Word address of first page 



B i 2 i \i 5 6 7 U » 16 l-i 1 12 15 14 isll6 17 Is tflio 21 ii 23I24 Is 26 iziis 29 30 31 

word 1 



Number of pages 



1 2 314 5 6 7IB 9 10 tTT)2 13 14 151 14 17 18 19120 21 22 23124 25 26 27128 29 30 3! 

The system checks to see ff the set of pages specified in the 
FPT are currently allocated real-time pages. On return 
from the CAL, the condition code setting will be as follows: 



113 4 




The pages specified are the RESDF 
segment. 



1 The pages specified are a DYNRESDF 

segment. 

10 All pages are currently allocated 

real-time pages but are not a speci- 
fic memory segment. 

10 Some, but not all of the pages are 

currently allocated real-time pages. 

10 None of the pages are currently 

allocated real-time pages. 
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10. TRANSACTION PROCESSES FACILITIES 



This chapter describes a program called the System Queue 
Manager and a procedure, that was designed for use by' 
Xerox in the development of the transaction processing 
facilities of CP-V. The procedure should never be included 
Fn any user-written programs. This chapter is intended for 
Xerox system programmers only. 



SYSTEM QUEUE MANAGER 

The System Queue Manager is a program that is part of the 
CP-V monitor. It is essentially a message switching system 
developed for transaction processing in CP-V. The Queue 
is maintained in core and overflows onto a disk file. This 
file is created, opened, closed and otherwise maintained by 
a privileged (CO or higher) program defined as the Queue 
owner. The Queue owner unlocks the Queue by executing 
the UNLOCK queue call and passing the ac'-'-ess of the 
Queue DCB to the Queue Manager. The Queue DCB must 
be open and must define a random file for the Queue. 
Once the Queue owner has been established and the Queue 
unlocked, only that task may LOCK the Queue and close 
the Queue file. The Queue file must remain open through- 
out the entire UN LOCK-LOCK session. 

Following the UNLOCK, the Queue owner stores the start- 
ing TID (transaction ID) into the Queue Manager's TTP table 
and Queue processing may begin. 

Programs with TP authorization may now process messages 
through the System Queue Manager. Each message has the 
format of a Formal Queue Message (see the GET message 
for this format). The entry name is defined as: 

first-name-segment. [. . . nth-name-segment.] TID 

Each name segment is separated by a period (. ). The final 
name segment is always the unique TID (in EBCDIC). See 
the M:GETID procedure which describes how these unique 
TID's are obtained. For TP, the first-name-segment con- 
sists of the identifier (? @ *) followed by the trancode or 
reportcode. The maximum length of the entry name is 
31 bytes. The first-name-segment length may be no larger 
than the KEYMAX specification on the UNLOCK request. 
The maximum length of the entry text is 1980 bytes. 

To GET messages from the Queue, the DEFINELIST request 
is issued to describe the criteria of the entries desired 
by this program. A criterion is defined as: 

first-name -segment. [. . . nth-name -segment] 

Each criterion must have at least one period (i.e., define 
at least the first-name-segment). The criterion is followed 
by a flag byte which tells the Queue Manager whether 
'failed' entries are acceptable or whether 'destructive 
readout 1 is in force. If destructive readout is requested, 
the Queue message is deleted from the Queue when it is 



moved to the user's buffer. Otherwise the Queue message 
is marked ih*-progress in the Queue and remains in-progress 
until its status is changed (to not-in -progress or failed) or 
it is deleted via a PUT request. 

The DEFINELIST request is followed by a GET request for 
that list (the LIST ID specified with the GET is returned from 
the DEFINELIST call). Once the GET has been issued the 
associated criteria become 'active'. This means that each 
time an entry is inserted in the Queue, the criteria will be 
compared to that entry and if a match is found, the ECB 
associated with the GET request will be posted with the 
X'02' completion code. When the ECB is posted, the GET 
request may be reissued to obtain the Queue message. Note 
that there is no guarantee that a reissuance of the request 
will actually get a Queue message, since another program 
may have gotten it or altered its status since the ECB posting; 
therefore the resulting condition codes may still indicate 
that the ECB wait is meaningful. When the condition codes 
are returned as zero, the Queue message has been placed 
in the specified buffer and SRI is set with the offset into the 
criteria list pointers describing which entry was obtained. 
An example of a typical GET routine is: . "* ?*', 

*LI S TI D , GE T , ( BUF , *ADDR ) ; ^.> 
, (BSI ZE , 5 12 ) , (ECB ,GExky*'B>J ■•**,£ 

GOTMSG : ^<V' : .^-* f- V 

ERRORCHK ABNORMAL <$&■;' SR3; ■"-■> 
(ECB ,GETECfi) -Vv j:,' ;">» lv /:\ '' 

ERRORECB . * v *•,;* *'-?""'*>. '?- K "'-;' 
GETMSG •' ""- ■**"" ", / ' :■ 

'$ *""■'.' 

* AT THIS POINT MSG HAS BEEN RECEIVED 

A program does not wait until a Queue message arrives which 
satisfies its active criteria. The WAIT option only waits to 
give the caller access to the Queue. If no ECB is specified 
on a GET request, the caller will get a Queue message if 
one is currently queued or will be given a BC-14 abnormal 
(return condition codes = 8) if a match is not currently in 
the Queue. 

The PUT request is used to insert a Queue message into the 
Queue, to alter the status of an existing in-progress entry, 
or to delete an in-progress entry from the Queue. Each 
entry in the 'put list' points to a specific Queue message 
and the flag byte in the list indicates what action is to be 
taken for that Queue message. For a PUT request, each 
item in the list is processed before return is made to the 
calling program. 

The PURGE request is issued to delete a currently defined 
get list (a previous DEFINELIST). When the criteria is no 
longer valid or useful, the PURGE should be requested to 
free up the list and criteria pages and the Queue Manager 
work space. 

-•Jhe STATS request returns the status of a Queue message 
'(i.e., Queued, Failed, In-progress, etc. ) and optionally the 



GETMSG 


M:QUEUE 




BCR.12 




BCS,8 




M:CHECKECB 




BNEZ 




B 


GOTMSG 


equ ;'-.. 
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count of entries queued which match the firsr-fowrie^egment 
of the specified criterion. The STATS list is always one 
item long. If no list is specified (list loc is 0), the STATS 
request returns the current status of Queue itself (i. e. , 
number of entries queued, number of entries in-progress, 
number of entries failed, etc. ). 

The LOCK request ends Queue processing. AH subsequent 
requests will be given the BC-11 (Queue Locked) abnormal 
code. The LOCK request must be issued by the same user 
(i.e., user number) which issued the UNLOCK request, 
since that user has been defined as the Queue owner. The 
LOCK causes the in-core queue pages to be flushed out to 
the Queue file and returns the in-core pages to the system. 



The format of the M:QUEUE procedure is 



M-.GETID PROCEDURE FORMAT 

Each Queue message that is placed in the System Queue 
must have a" unique identifier appended to the entry name. 
This identifier is obtained from the Queue Manager by 
issuing an M:GETID call. The TID is returned in hexa- 
decimal in register SRI. It must be converted to eight 
EBCDIC characters and appended to the entry name . The 
TID is, always the final -name-segment of a queue entry 
^ toipejrfhd is separated from the other name segments with 

"i'H^peVlod ■(,) delimiter. The format of the procedure 

^-Gajf-fri^'-;.' '■' ! 

Calls generated by the M:GETID procedure have the form 
CAL1,7 fpt 

where fpt points to the FPT shown below. 



X'OD' 



1 2 3 L 5 6 7 I 8 9 10 11112 13 14 ulli 17 II 19 1 20 21 22 23 1 24 25 26 27 1 28 29 X 31 

If the queue is locked when the call is issued, no TID 
is placed in SRI and return is made to CAL+1 with CC1 
set. 



! Mfflmt PROCEDURE FQ&H8AT i 

i 

In transaction processing, the flow of transactions and re- 
ports is controlled through a single queue by the System 
Queue Manager. The M:QUEUE procedure was developed 
for use in the System Queue Manager and requires trans- 
action processing authorization (via the Super processor). 



MfQUEUE 



[*]deb address 
[*]lisT loc 
[*]iist id 



UNLOCK ' 

DEFINELIST 

PUT 

GET 

STATS 

PURGE 

LOCK 



[,(option)]. . . 



where 



deb address specifies the address of the DCB for 
UNLOCK and LOCK requests. 

list loc specifies the location of the list of criteria 
pointers for PUT, DEFINELIST, and STATS requests. 

list id specifies the id of a list for GET and PURGE 
requests. 

UNLOCK activates usage of the queue and de- 
fines the queue owner. 

DEFINELIST defines the criteria for subsequent 
GET requests (i.e., the GET lists). 

PUT enters a transaction or report into the queue. 

GET retrieves a transaction or report from the 
queue. 

- STATS returns the status of a transaction or report. 

PURGE discards outstanding GET lists which are 
activefor a given user and releases user-associated 
queue control tables. 

LOCK ensures that the user is the queue owner and 
locks the queue from further use. 

The basic options are as fol lows: 

LSIZE,t*J value specifies the size of the list for 
PUT or DEFINELIST. . 

BUF, L*J aaa, ress specifies the buffer address for re- 
turning aqueue entry for a GET request or for return- 
ing queue status information for a STATS request. 

BSIZE, [*] value specifies the size (in words) of the 
area defined by the BUF option. 

WAIT specifies that the caller wishes to wait for 
access to the queue prior to resuming execution. 

ECB, [*J address specifies the address of an ECB to 
be posted when a queue event occurs. A queue 
event may be: the arrival of an entry to the queue 
which satisfies an active GET list; the availability 
of the queue (when the WAIT option was not indi- 
cated on the original queue request); or queue 
space availability. 
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The following option is applicable only to the GET request: 

INDEX, [*Jva!ue specifies the word displacement 

within the GET list to start the search for a criteria 
match. 

The following option is applicable only "to the PUT request: 

(HTCH1 
I OW I specifies the priority for PUT requests. 

The following options are applicable only to the UNLOCK 
request: 

IKIFWI specifies whether the queue is a new or 

existing file. 

BACKUP specifies that the queue is to be kept up- 
to-date on secondary storage, (i. e. , whenever a 
queue block is modified in core it is to be written 
to disk). 

QPAGES, [*J value specifies the maximum number of 
core pages which can be used for queue blocks and 
queue manager work pages. 

QSAT, L*J value specifies the percentage of queue 
capacity for acceptance of high priority PUTs only. 

KEYMAX,[*J value specifies the maximum number 
of bytes required to contain any name (trancode) 
presented for enqueueing(l-13 may be specified). 

RECOVER specifies queue unlock for recovery mode. 

The following option is applicable only to the STATS request: 

COUNT specifies that the number of occurrences 
in the queue of a specified criterion is to be re- 
turned in the second halfword of SRI. 

The following option is applicable only to the LOCK request: 

PAUSE specifies that the queue lock is temporary 
and current users may continue processing their 
current outstanding requests when the queue is 
unlocked. 



M:Q0EUE flimiM PARAMETER TABLES (FPTS] 

Calls generated by the M.-QUEUE procedure have the form 

CAL1,7 fpt 

where fpt points to word of an FPT. The code in the first 
byte of word is as follows: 

FPT Code Function 



X'06' 
X'07' 



UNLOCK 
DEFINELIST 



FPT Code Function 



X'08' 


PUT 


X'09' 


GET A 


X'OA' 


STATS 


X'OB' 


PURGE 


X'OC 


LOCK 



The various FPT formats are described in the sections that 
follow. 



QUEUE UNLOCK REQUEST 

The format of the FPT for the UNLOCK request is: 
word 



X'06' 



0- 



-0 



DCB address 



O'l 2 3U 5 6 716 9 10 1 TT 12 13 14 IS I 16 17 18 IS" 1 20 21 22 23(24 25 26 27(28 29 30 31 



word 1 



1 2 lit 5 6 718 9 10 HI 12 13 14 151 16 17 18 19120 21 22 23l24^>5 26 27T28 29 30 31 







where 



F. = 1 means WAIT option specified. 
F =. 1 means BACKUP option specified. 
F_ = 1 means NEW option specified. 



F , = 1 means RECOVER specified, 
option ECB (P]j 







-0 



ECB address 



1 2 3 1 4 5 6 7 I 8 9 10 11 1 12 13 14 15(16 17 18 I9I2O 21 22 23 1 24 25 26 27 1 28 29 30 3 



option Q PAGES (P2) 



,0- 



Number of queue 
core pages 



1 2 3 14 5 6 7 18 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27I2B 29 30 31 



option KEYMAX (P3) 



Key size 



I 2 3 14 5 6 7 18 9 10 11112 13 14 15116 17 18 19120 51 22 23124 25'26 27128 29 30 31 



option QSAT (P4) 







Saturation % 



1 2 3I4 5 6 7 Is 9 10 ll(l2 13 14 I5I16 17 18 19(20 21 22 23124 25 26 27I28 29 30 31 



QUEUE DEFIKEUST REQUEST 



The format of the FPT for DEFINELIST is: 
word 



X'07' 



0- 



List address 



f } 3 14- 5 6 ? I S 9 Id III 12 13 w'liU 17 M I9l20 21 22 23fi4 25 26 27 1 1 2S 29 30 31 
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w 


or 


d 1 




- 






p 
» 


9 
1 


0- 




A 


t 







1 ^ -\ u 


& 


1 


: 3 1 


l !"• >li 


»"T4 Itlll !) 14 Ulli »> :U,;iff» }Vy »Hi H~BTT» W » >f 



where Fj = 1 means WAIT option specified, 
option ECB (Pi) 



ECB address 



option List Size (P2) 



* 0- 



n l < i « Hi i a nti 



List size 



I* 17 II I* I ]Q 21 22 Wlw 25 26 J7lh }♦ 30 if 



QUEUE PUT REQUEST 



The format of the FPT for PUT is: 
word 



* 


X'08' 





List address 


13 3 14 5 6 7 

word 1 


1 I'M III 12 13 14 151 14 17 It 1*120 21 22 23124 23 26 27 1 21 2» 30 31 


i 


p 

7 


ft fl 


f 
2 


f 
1 





u u 





! 


J 3 1 4 3 4 7 


« « K> III 12 11 14 


151 16 17 II 1*120 21 22 23124 25 


26 


}7 


M » 16 ]i 



where 

F. = 1 means WAIT option specified. 

F2 = means low priority request. 
F2 = 1 means high priority request. 

option ECB (P]) 



ECB address 



12 3 ! « 3* 7l» » 10 111 12 13 14 nil* 17 II 1»ItO 21 22 23124 23 2* V\2* It X i 

option List size (P2) 



0""T 2 jf 4 5 6 7 ll * 10 III 12 I) 14 I! 



List size 



16 )7 it iMio 21 }2 iitii fa 26 Or \ H r> 36 31 



option Index (P2) 



Index 



1 



ft i i hU i 6 rl.i y is u t ii ii u mu v u w I b si » hli« 23 via a" a is ir 
option Buff&r address (P3) 



Buffer address 



J I ] 111""}"* 5ll » 10 111 13 U M isll» 17 II 111* 21 t) J3I24' !3 26 J?i2t 2* » 11 

option Buffer size (P4) 



Buffer size 



Oil 114 5 4 711 I 10 lit 12 13 14 13 16 17 ll It 1 20 ll 22 23124 25 26 27121 2* 30 31 

QUEUE STATS REQUEST 

The format of the FPT for STATS is: 
word 



* Y«ftAi 



X'OA' 



List address 



12 ill 5 4 7lt 9 10 Illl2 13 14 is! 14 17 II 1*1 20 21 22 23 1 24 23 26 i'lll » 30 31 

word 1 







1 2 ill ) 6 rli ♦ 10 illl2 13 14 isll* 17 It l»(2& 21 22 l}1i« 25 it 2712* 2» 16 3 

where 

F2 = 1 means COUNT option specified. 
F| = 1 means WAIT option specified. 

option ECB (Pi) 



ECB address 



1 2 )l4 } 4 7 ll * 1C 111 12 11 14 isll4 17 II !»!» 21 22 23 1 24 25 26 27 1 SB 2» 30 }• 



option BUF (Pff 



Buffer address 



Oil 3 I 4 } 6 7 ll » 10 111 12 13 14 15 1 16 17 II l» 1 20 21 22 23 1 24 25 26 27 1 28 



option BSIZE (P4) 




* 




VT'j'ti ■ v »■■ 7 1 1 » is nl n' rnrB 


Buffer size 
Tr-Tf-TrTrtjB-jrTT'jjtirsjrytH^ » jt 



QUEUE GET REQUEST 

The format of the FPT for GET is: 
word 



X'09' 



List id 



3I24 23 26 27I2 



1 2 3 14 5 6 Tie » 10 111 12 II U 131 16 17 II I»I20 21 22 23124 23 26 27121 29 30 31 

word 1 



'l 2 







'B*T'3* T 1' 4 S 6 ?l i i IS l lll i 13 U H i U l > I I tt t » il » « ( }< • » if P l H H 18 If 

where Fj - 1 means WAIT option specified, 
option ECB (P]) 



ECB address 



\ i S 1 1 s i Ml t 1 8 l t t li » u ' niit I ? It H l M 31 H il ' ii H 26 P t H X » 5 



QUEUE PURSE REQUEST 

The format of the FPT for PURGE is: 
word 



X'OB' 



List id 



word 1 







l*\ i IN 1 4 HI » to illii ii u ist i* !T liiMJo Ji 51 Mi* h 26*2;l2t 2* ]6 3. 

where F] = 1 means WAIT option specified. 
option ECB {?]) 



ECB address 



T\ 2 1 14 3 4 'It ♦ 10 lit 13 U 14 15I16 17 11 19 1 20 21 22 23J24 23 26 2? 1 28 ?> » )l 
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QUEUE-LOCK REGOEST 

The fo'nvaf of the FPT for LOCK is 
word ' 



* 


X'QC 


0- 




— -0 


, ,DC'B address 


6 i 3 ;■'■«- ■ <■ ' 

word i 


8 • 


10 1.1 1 1 


! 13 14 l 


,1 14 17 .ijf -1*1 JO 71. ■«' j;l<4 75 36 27I28 2» 30 31 


p 




» 0-0| . 


— 


u 








\J 





1 ? 3 ! 4 5 4 7 


1 5 


10 III 12 13 14 1 


stl6 17 18 I'ljO Jl 72 


23(24 2 J 24 27 


j» it 30 31 



Fj - 1 means WAIT option specified. 

F5 - 1 means PAUSE option specified. 

option ECB (Pi) 



ECB address 



1 J 3 l« 5 4 7la » 10 llllj 13 14 15 1 14 17 18 l»l» Jl 22 J3lj< 25 24 lAl* 2» 30 31 

UST FOUNTS 

DEFIMELIST OR STATS LIST 

The format of the DEFINELIST or STATS list is: 



Name] length 



Virtual byte address of criterion] 



i } 3 I 4 5 4 7 18 » 10 llllj 13 14 15ll4 17 18 !»!» 21 11 23I 2* 23 24 27 1 36 19 30 31 



Name n length 



1 2 3 1 4 > 4 7 



Virtual byte address of criterion n 



6 » 10 111 12 13 14 15 1 16 17 18 I»l20 21 22 23 1 24 25 24 27(28 29 30 31 



The criterion is in TEXT format name-segments followed by 
a flag byte. At least one period must appear in the criterion 
name. 

The flag byte has the format 



i.i 1 [>i ■.- 

i i 3T4 



wher 



F is set to one if failed entries are acceptable 
(i.e., the system is to GET the transaction re- 
gardless of whether or not if was successful). 

D is set to one if the entry is to be destroyed after 
it has been read. 



Note: This list must be completely contained within a 
single page of memory. 



■ SET ft&SAG'E 

The format of the GET message is: 
word t t 



JI 



12 3 4 7 8 



Length of record (bytes) 



(Unused by the queue manager) 



Lenglh of entry text (byte*) 



Length cf entry 
name (bytes) 



Entry name 



Entry text 



where 

Q indicates queued and is always set to one. 

F indicates failed, if set to one. 

JI are journalization indicators. Although these 
bits are kept in this status byte, the queue man- 
ager does not use this information. The informa- 
tion is stored here for use by other transaction 
processors. 

PUT LIST 

The format of the PUT list is: 



Flags 



• Virtual word address of entry] 



a \ i st r 1 4 i h t ' ia nhi ii u »U i > » i« 1 h t\ a n \ u g a a \ n » gn 



Flags 



Virtual word address of entry2 



6 I } i t f 54 "HI * 16 \\ l \i li U Is! ; t 17 It itito 5 r»h l i4 K K ' fr l M » 36 i 

where the entries are in journal record format. (See the 
GET message, above, for this format.) 

The first four bits of the flags field have the following 
meaning: 

Q - F P 



1 Delete in-progress entry. 

1 1 Delete special bypass entry. 

Insert special bypass entry. 

Insert an entry into the queue. * 

1 1 Mark an entry failed. 

1 Put an in-progress entry back into 
the queue. 

1 Insert a pre-failed entry into the 
queue. 












1 


1 


1 


1 





1 





1 






1 
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The .J I field contains jo.urrio,M nation ifjdfcators. Although ". 
these bits ore kept in this status byte, the queue manager 
does not use this information." The information is stored here 
for use by the transaction processors. 



RfcQUEUE PROCEDURE OUTPUT PARAMETERS 

SR1 INFORMATION 

UNLOCK: Transaction id returned in SRI 



8-character hexadecimal transaction id 



1 I 3l« 5 6 7 1 « » 10 llll! 13 14 !ill6 17 II !»!» 31 22 »!?< }J 26 J?!j» r> 30 31 

DEFiNELIST: List-id returned in SRI 















4 digit hexadecimal list id 



1! i J 3+4 5 6 /It * 10 111 I? 13 14 ISl 14 17 It 1*1 30 21 22 23 1 ?4 21 26 J7Im 1* 30 31 

GET: Word displacement within the list to the criterion for 
which an entry has been stored in the caller's buffer. 
The format of the entry itself is given in the List For- 
mats section. 

Displacement returned in SRI 



Word displacement 
1 -X'FFFF' 



Z i "l ftl 5 6 7 I 6 5 10 111 12 13 M 13116 17 IS !»l 20 21 23 22-24 3: 26 27 1 28 29 30 3 

PUT: Word displacement within an erroneous list to the entry 
in error. (The SRI format is the same as for GET.) If 
no errors occur, SRI .is meaningless. 

STATS: The status of a queue entryand, optionally, a count 
of such entries are returned in SRI 



Enfry count 



01 231* T~6 7 18 « 10 III 12 I] 14 151 I* 17 1) I*Ik 21 23 23 1 24 2J 26 27 1 2* 2» » 3' 

where 

Bit = 1 means entry queued. 

Bit 1 = 1 means reserved. 

Bit 2 - 1 means entry in failed status. 

Bit 3 = 1 means entry in progress, i.e., given to a 
transaction processor. 



ECB INFORRfiATIOil 

ECB completion codes for a queue request are: 

X'01' An entry has been placed in the caller's buf- 
fer. (Posted on a GET request only. ) 

X'02' Normal return. For a GET request, an entry 

is present. Request it again. 

X'OF' Abnormal return. (SR3 contains the abnormal 
code. ) 




CONDITION CODE SETTINGS 

When the M:QUEUE procedure is performed, the following 
condition code settings may result: 

Status . • 

Normal return. 

Queue unavailable or request cannot 
be satisfied. (Abnormal code is 
in SR3.) 

ECB wait is meaningful. 



QUEUE ERR08 COOES 

Errors detected by the system Queue Manager result in 
error notification to the caller or a user abort. The error 
code for M:QUEUE CALs is X'BO. The code is communi- 
cated to the caller in SR3 and, if the ECB option is speci- 
fied, in the ECB. The code is contained in byte of SR3, 
a subcode is contained in bits 8-14, and the content of the 
FPT word 0, bits 15-31 is returned in the rightmost 17 bits 
of SR3. Therefore SR3 may contain the deb address, listloc 
or listid depending upon the queue request. The error sub- 
codes are listed in Table 46. 



Table 46. M:QUEUE Error Subcodes 



Subcode 


Meaning 


01 


Illegal queue service requested 
(e.g., an unlock is requested and 
the queue is not locked or the 
caller is not an authorized TP 
user). The task is aborted. 


02 


An event not associated with the 
queue has occurred for the user 
(e.g., M:INT, abort, ESCope or 
BREAK). 


03 


Error return from get physical work 
page (abort during unlock pro- 
cessing only). 


07 


Queue saturated; i.e., index core 
space or queue secondary storage 
space is unavailable. 


08 


Queue lock or unlock caller does 
not have the required privilege. 
The task is aborted. 
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>abie 46. MrQUEUE error Subcodes (cont. ) 



Subcode , , 


Meaning 


09 


DCB not open for aMpck or unlock 
request. The task is aborted. 


0A 


Space is hot available to define a 
list. 


10 


Error in specified address, size, 
or queue message format. 


n 


Queue locked. 


12 


Queue physical page space is not 
available. 


13 


Error in the FPT parameters or the 
specified list. 


14 


Entry not found or a queue request 
requiring an existing entry. 


15 


I/O error during control/index 
transfer for an unlock request. 
The task is aborted. 



T.ablo 46. M:QUEUE Error Subcodes (cont. > 


Subcode 


Meaning ' 


16 


I/O error during a data block 




transfer. 


17 


Queue busy. Either current user 




has tried to lock the queue while 




in vi9 by another user, or the 




queue is in a pause status due to a 




volume switch operation on the 




journal tape. 


20 


Queue GET or PURGE request for 




o non-existent GET list. 


21 


Queue has not. been initialized, 




but users are permitted to access 
it. 


23 


A name-segment must be com- 




prised only of upper/lower case 




alphabetic characters and/or the 




EBCDIC representation of the 




numbers through 9. 
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APPEK&K k OPERATIONAL LABELS 



Table A-l. Standard Operational Labels and 
'Default Device Assignments 



Table A-2* Batch Assignment of Operational 
Labels 



Opera- 
tional 




On-Line 


Ghost 


Label 


Batch Device 


Device 


Device 


C 


Card reader ' 


Terminal 


Operator's 
console 


OC 


Operator's 


Terminal 


Operator's 




console 




console 


LO 


Line printer 


Terminal 


Line printer 


LL 


Line printer 


Terminal 


Line printer 


DO 


Line printer 


Terminal 


Line printer 


PO 


Card punch 


None 


Card punch 


BO 


Card punch 


None 


Card punch 


LI 


Card reader 


None 


Operator's 
console 


SI 


Card reader 


Terminal 


Operator's 
console 


BI 


Card reader 


None 


Operator's 
console 


SL 


Line printer 


Terminal 


Line printer 


SO 


Card punch 


None 


Card punch 


CI 


Card reader 


None 


Operator's 
console 


CO 


Card punch 


None 


Card punch 


AL 


Card punch 


None 


Card punch 


EI 


Card reader 


Terminal 


Operator's 
console 


EO 


Card punch 


None 


Card punch 


UC 


Operator's 


Terminal 


Operator 's 




console 




console 



Device 


Oplabel 


Line printer 


LO, LL, DO, SL, LP 


Card reader 


C, LI, SI, BI, CI, EI, CR 


Card^wflich 


PO, BO, SO, CO, AL, 
EO, CP 


Opercftor's console 


OC, UC 


9-track magnetic tape 


9T 


7-trackr magnetic tape 


7T 


Default tape 


MT 


None 


NO, ME 



Table A-3. On-Line Assignment of Operational 
Labels 



Device 


Oplabel 


User's terminal 


C, OC, LO, LL, DO, SI, 
SL, EI, UC, ME, CR 


Card punch 


CP 


Line printer 


LP 


9-track magnetic tape 


9T 


7-track magnetic tape 


7T 


Default tape 


MT 


None 


NO, PO, BO, LI, BI, SO, 
CI, CO, AL, EO, PR, PP 
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A physical device name is indicated by yyndd. 

where 

yy specifies the type of device (see Table B-l). 

n specifies the IOP letter for Sigma computers (see 
Table B-2)or cluster/unit for the Xerox 560 (see 
Table B-3). 

dd specifies the device number (see Table B-4), 
in hexadecimal. 



Table B-l. Standard I/O Device Type Codes 



Table B-2. Sigma IOP Designation Codes 



yy 


Device Type 


71 


7-track magnetic tape 


9T 


9-track magnetic tape 


CP 


Card punch 


CR 


Card reader 


TY 


Typewriter 


LP 


Line printer 


DP 


Disk pack 


DC 


Magnetic disk 


ME 


CP-V terminal 


RB 


Remote processing data set 
controller 


XP 


Optical character printer 


. MO 


Message mode communica- 
tions equipment 


MC 


Remote assist terminal 
(maintenance console) 



IOP 




Letter (n) 


Unit Address 


A 





B 


1 


C 


2 


D 


3 


E 


4 


F 


5 


G 


6 


H 


7 



Table 


B-3. 


Xerox 560 Cluster/Unit Matrix 




Unit 
Number 


Cluster Number 








1 


2 3 4 5 6 


7 


A 


B 


H N T Z 5 


* 


1 


$ 


C 


I O U 6 


* ' 


2 


# 


D 


J P VI 7 


' .* 


3 


@ 


E 


K Q W 2 8 


* 


4 


: 


F 


L R X 3 9 


* 


5 


* 


G 


M S Y 4 L-J 


* 


6 


*. 


* 


* * * * * 


* 


7 


* 


* 


***** 


* 


* 
Reserved 



Table B-4. 


Device Designation Codes 


Hexadecimal 
Code (dd) 


Device 
Designation 


00<dd<7F 
80<dd<FF 


Refers to a device number 
(00 through 7F). 

Refers to a device controller 
number (8 through F followed by 
a device number 9 through F). 
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APPENDIX C. CP-V- SOFTWARE CHECK CORE 



Table C-l . CP-V Software Check Codes 



Code: 01 

Called From: 

Message: 

Registers: 



Remarks: 



SCHED, MM 

USERS- PAGE CHAIN INCONSISTENT 

When called from SCHED: 

RO - if circular or unlinked chain; otherwise/ the Link number index in chain. 

Rl - Link register. 

R2 - Next page chain link. 

R4 - User being scheduled. 

R7 - Address of Chain Head, Tail, and Count Table. 

SR4 - Offending page number. 

When called from MM (T:XPGVl): 

Rl - Zero. 

R3 - Physical page number. 

R7 - Virtual page number. 

The requested virtual page in the user virtual map chain (JB:LMAP) can't be found. See T:PGCHK 
in SCHED. Effective when SSI set. 



Code; 02 

Called From: 

Message: 

Registers: 



Remarks: 



SCHED 

REPORTED EVENT INCONSISTENT WITH USER'S CURRENT STATE 

R3 - Previous state. 

R4 - User number (T:RE, T.-RCE). 

R5 - User number (T:RUE). 

R6 - Event number. . 

R7 - Line number (T:RCE). 

SR4 - Return address for reschedule. 

The contents of R3 through R7 are dependent upon the called entry point. If R4 = S:CU, the 
call was T:RE. If R7 is the line number of the user in R4, thecal! was T:RCE. If R4 = R5, 
the entry is T:RUE. 



Code: 04-04 
Called From: 
Remarks: 



SCHED 

Code is reserved for system zap and reboot after a zap. 



Code: QA 

Called From: 

Message: 

Registers: 



DPSIO, TSIO 

OPCODE IN SWAP COMMAND CHAIN IS INVALID 

Case 1 , command list security checks — SS4 set: 

Rl - Incorrect command list order code if not equal to R3. 

R2 - Incorrect command list entry address (IOCD). 

R3 - Order code of first IOCD in command list. 

R4 - Swap device index. 

R6 - Command list beginning address. 

R7 - Swapper function code. 
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Table C-l. CP-V Software Check Codes (conf. ) 






Case 2, Unrecoverable read error during inswap: 






Rl'-.r Inswap user number. 

R7 - DCT index. ' 

SRI - Incorrect command list' entry address (IOCD). 

Dl - Order code. 




Code: OB 






Called From: 


DPSIO, TSIO 




Message: 


INCORRECT ORDER CODE IN SWAP COMMAND LIST 




Registers: 


Rl - Incorrect order code; not seek. 
R2-R7 - See case 1 of screech code OA above. 




Remarks: 


SS4 must be on for check. 




Code: OC 






Called From: 


DPSIO, TSIO 


■ 


Message: 


ATTEMPT TO SWAP MONITOR'S MEMORY 

i 


' 


Registers: 


I 

|*1 Buffer address. 

R2-R7 - See case 1 of screech code OA above. 




Remarks: 


SS4 must be on for check. 




Code: OD 






Called From: 


TSIO 




Message: 


HALT FLAGS MISSING IN SWAP COMMAND LIST 




Registers: 


RO FLAGS byte from TIC command. 

Rl TIC order code. 

R2-R7 - See case 1 of screech code OA above. 




Remarks: 


SS4 must be set to check. FLAGS must not have command chaining set and must have 
zero-byte -counter or channel -end set. 


interrupt -on- 


Code: OE 






Called From: 


TSIO 




Message: 


I/O REQUEST WITH NULL COMMAND LIST 




Registers: 


R4 - Swap device index. 

R6 - Command list beginning address. 

R7 - Swapper function code. 




Remarks: 


Not checked for pack-only swappers. 
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Table C-l. CP-V Software Check Codes (cont. 



Code: OF 




Called From: 


DPSIO, TSIO 


Message: 


INPUT FUNCTION CODE IS INVALID 


« Registers: 


R2 - Swapper function code. 
D4 - X'0F\ 


Remarks: 


SS4 must be on to check. Function code not between one and five exclusively. 


Code: 10 




Called From: 


COC, ECBBLK 


Message: 


BAD COC BUF POOL, OR BAD BUF ADR ON RELEASE REQUEST 


Registers: 


R2 - Logical line number. 

R4 - Buffer address. 

R6 - Return address from buffer return call. 


Remarks: 


1. On a COC buffer release, an invalid relative buffer address was specified (address 15 or 
HRBAM+15). 


: 


2. On a COC buffer GET or RELEASE, an invalid relative buffer address was found in the free 
pool chain. If the COC module was assembled with the COCGBUG and COCPBUG flags set 
(normally they're not), and sense switch 4 is set, the entire free pool chain is checked on each 
PUT and GET operation. (The R4 and R6 contents listed above are valid only at entry and exit 
times.) 


Code: 11 




Called From: 


COC 


Message: 


INVALID INTERNAL CONTROL CODE. TRANSLATE REQUEST 


Registers: 


Rl - DCB address. 

R2 - Line number. 

R5 - Character. 

R7 - Byte address of user buffer. 

SR2 - Return address. 

SR3 - Output translation table address. 


Remarks: 


The cause is a translate table error (e.g., 2741 N/L on non-2741 line), or a bad input buffer chain. 
Rl, R7, and SR4 are not always set. 


Code: 12 




Called From: 


COC 


Message: 


COC -BAD INPUT BUF LINKAGE ON RELEASE REQUEST 


Registers: 


RO - Removal point. 

Rl - DCB address. 

R2 - Line number. 

R3 - COC number. 

R4 - Current release point. 

SR3 - Output translate table address. 
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Table C-l. CP-^-V Software Check Codes' ,(conr. ) 





SR4 - Caller's return;, RTN + ■•? = activation. ' 
D3 - Return address. 


Remarks: 


The COC input buffers are being released, and there is a conflict between the insertion and removal 
points and the chain. RO; Rl, R3, and R4 are not always set. 


Code: 13 




Called From: 


COC 


Message: 


COC -OUTPUT BUF LINKAGE OR CHARACTER COUNT BAD 


Registers: 


Rl - DCB address. 

R2 - Line number. 

R3 - COC number. 

R4 - Removal point (usually negative). 

R5 - Character. 

SR4 - Output count; usually = — 1. 


Remarks: 


The output count and buffers are inconsistent. This may be caused by extended interrupt pulse or 
clobbered COC tables -usually COCOC, COCOI, or COCOR. Rl is not always set. 


Code: 14 


) 


Called From: 


THEUNCOC 


Message : 


COC ROUTINE CALLED IN NON-COC SYSTEM 


Registers: 


SR2 - BAL adr if 14-03. 

SR4 - BAL adr if 14-01 or 14-02. 

D4 - BAL adr if 14-04. 


Remarks: 


The subcode indicates which routine was called: 


. 


14-01 COCIO 
14-02 COCOFF 
14-03 COCSENDX 
14-04 ECHOCR2* 


Code: 17 




Called From: 


IOQ 


Message: 


INVALID DISK ADDRESS PASSED FOR AN I/O INSTRUCTION 


Registers: 


Rl - IOQ7,R3 = DCTX = 0. 

R2 - DCB address. 

ft3 - Queue index. 

SRI - Seek address from CDA, R2. 

D4 - X'17'. 


Remarks: 


Caused by an invalid DCT index. R2 and SRI are not always set. If the invalid address is on a RAD 
or disk, DSCVT will have been called and R2 and SRI will be set. 
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Table C-l. CP-V Software Check Codes (tont. 



Code: 19 

Called From: 

Message: 

Registers: 



Remarks: 



BUFF 

INVALID BUFFER ADDRESS PASSED FOR RELEASE 

Rl - Index to BUFLIMS. 

R2 - Head of respective buffer pool. 

R5 - JIT address. 

SR4 - Link return address. 

D3 - Buffer address. 

D4 - X'19'. 

Occurs both on releasing and acquiring buffers of most types (CPOOL, SPOOL/ and MPOOL). 



Code: 19-01 
Called From: 
Message: 
Registers: 

Remarks: 



MPCDIO 

TOO MANY CDWS IN MPOOL 

Rl = DCT index 

R2 = CIT Index 

R3 = I OQ index 

R12 = Actual number of CDWs in request 

An I/O request passed to the MPC disk handler may containat most 5 command doublewords. 



Code: 1A 
Called From: 
Message : 
Registers: 
Remarks: 



CLS 



ACCOUNT DIRECTORY INACCESSIBLE 



The account directory is bad and the monitor is unable to reconstruct it. All files are lost. 



Code: IB 
Called From: 
Message: 
Registers: 



Remarks: 



Swapper 

USERS PAGE CHAIN NON ZERO AT SWAP COMPLETION 

Rl - Inswap user number (S:ISUN). 

R2 - Physical byte address of JIT. 

R3 - UB.-US, I (user state). 

R4 - Physical page head. 

R5 - Physical page tail. 

R6 - Physical page count. 

SR4 - Count of swapper free page chain (S:FPPC). 

Swappers' free page pool must be nonzero at end of inswap. S:FPPH, S:FPPT contain head and tai 
of pages just allocated to the inswap user. 
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Code: 1C'09 






Called From: 


SWAPPER 




Message: 


INSWAP PROCESSOR SfZE^EXCEEDS SIZE OF CUST 




Registers: 


Rl = Index Into processor inswap list 

R3 = Inswap processor number 

R4 = No. of pages by which processor size exceeds available CLIST space. 




Remarks: 


A shared processor (possibly with an overlay) cannot be inswapped because its size exceeds the size 
of the command list space used for processor swapping. 




Code: 10 






Called From 


T:OV 




Message : 


REQUESTED OVERLAY NUMBER IS OUT OF RANGE 




Registers: 


R2 - Overlay name. 
R3 - Overlay name. 
R4 - 0. 
D4 - X'lD'. 




Remarks: 


Requested monitor overlay is not in shared processor table. 




Code: IF 






Called From: 


SWAPPER 




Message : 


NOT ENOUGH PAGES TO PERFORM THIS SWAP, 


• 


Registers: 


R3 - Page to release. 

SRI - Deficient page count. 




Code: 21 






Called From: 


MM 




Message: 


ATTEMPT TO SET ACCESS CONTROLS ON NON-EXISTENT VIRTUAL PAGE 




Registers: 


R6 - Number of pages to set. 
R7 - Virtual page number. 
SR4 - Link register. 




Code: 22 






Called From: 


PV 




Message: 


PRIVATE VOLUME ALLOCATION ERROR 
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Registers: R2 - SN count. 

f -. R3 - DCB volume number. 

R4 - SYSID (0 = EXCLusive use). 

R6 - DCB address. 
SR4 - Return address. 

D2 - DCB:SNT. 

D4 - X'22\ 

Remarks: Error in allocation. The specified entry in AVRTAB is not found or has bad flags. 



Code: 23 
Called From: 
Message: 
Registers: 
Remarks: 



CSE57, CSE59, CSEX560, CSECOM 
INVALID ENTRY TO CSE HANDLERS 

Entry was made to an unused slot of the CSE branch vector for this machine. 



•Hr 



*Code: 24 
Coiled From: 
Message: 

Registers: 

Remarks:" 



CSEHAND 

INSTRUCTION EXCEPTION TRAP. IN MASTER MODE 



A trap X'4D' occurred while in the master mode. A slave mode trap causes a normal user job step 
abort. All relevant information is in the in-core error log buffer. 



Code: 25 
Called From: 
Message: 
Registers: 
Remarks: 



CSEHAND 

UNRECOVERABLE WATCHDOG TIMER TRAP 



Sigma 9 and Xerox 560 systems will atempt recovery from watchdog timer traps resulting from \/0 
instructions without screeching. All relevant information is in the in-core error log buffer. 



Code: 20 
Called From: 
Message: 
Registers: 
Remarks: 



CSEHAND 

CSE TRAP DURING MFI, PFI HANDLING 



During MFI handling on a Sigma 9 or during MFI or PFI handling on a Xerox 560, a CSE trap (X'46', 
X'4C', X'4D') occurred. All relevant information is in the in-core error log buffer. 
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Table C-1 . CP-V Software Check Codes (con* .) 



Code: 27 
Colled From: 
Message: 
Registers: 
Remarks: 



CSEHAND 

PROCESSOR FAULT INTERRUPT 



A processor fault interrupt occurred for which continued operation is unlikely. All relevant infor- 
mation is in the in-core error log buffer. (Xerox 560 systems only. ) 



Code: 28 
Called From: 
Message: 
Registers: 

Remarks: 



CSEHAND 

MEMORY PARITY ERROR -MEMORY ALTERED 



A memory parity error correction caused memory to be altered. Continuation without recovery is not 
possible. Caused by interrupt X'56' on Sigma 6 or 7 or trap X'4C' in Sigma 9 or Xerox 560. Alf 
relevant information is in the in-core error log buffer. 



Code: 28-00 
Called From: 
Message: 
Registers: 
Remarks: 



CSEHAND 

TRAP 4C -BUS CHECK FAULT 



A Sigma 9 bus check fault or a Xer6x 560 miscellaneous trap X'4C occurred while in the master 
mode. All relevant information is in the in-core error log buffer. 



Code: 28-01 
Called From: 
Message: 
Registers: 
Remarks: 



CSEHAND 

TRAP 4C -MAP PARITY ERROR 



A map register parity error occurred on a Sigma 9 or Xerox 560 while in the master mode. All rel- 
evant information is in the in-core error log buffer. 



Code: 29-02 

Called From: CSEHAND 



Message: 
Registers: 
Remarks: 



TRAP 4C - REGISTER BLOCK PARITY ERROR 



A register block parity error occurred on the Xerox 560 wriile in the master mode. All relevant in- 
formation is in the in-core error log buffer. 
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"3- . ■ 



Code: 29-03 
Called From: 
Message: 
Registers: 
Remarks: 



CSEHAND 

TRAP 4C -WR1TELOCK REGISTER PARITY ERROR 



A write lock register parity error occurred on the Xerox 560 while in the master mode. All relevant 
information is in the. in-core error log buffer. 



Code: 2C-00 
Called From: 
Message: 
Registers: 



Remarks: 



ADD 

BATCH SCHEDULING ERROR - MBS/CC1 ERROR 

Rl - (S:CUN) current user number. 

R2 - Device type. 

R3 - Context block address. 

R5 - 0. 

R6 - User's DCB address (M:C). 

SR2 - OPNLD + .14. 

SR3 - Context block address. 

SR4 - OPNLD + .40. 

Dl - BA(OPNLD + .lE7)+ .28. 

D2 - BA(CONTXT BLK + SCFQARGS) + .28. 

D3 - Device type mnemonic text. 

Register contents significantly different from above indicate the monitor wandered into GETJ in ADD. 
Otherwise, a batch user has been created and has read a card before MBS selected him to be run. 
Actually all recorded 2C's have been CO attempting to start a second job. Problem is either CO 
read past FIN or a MBS/GETI communication problem (e.g., GIB:UN clobbered). 



Code: 20-00 

Called From: COOP 

Message: 

Registers: 



COOPERATIVE BUFFER MANAGEMENT ERROR 



Remarks: 



Rl - BUFLIMS index for screech code 19. 

R2 - .BCU. 

R3 - Context block. 

SR4 - COOP+.18D. 

D3 - 0. 

At context block initialization a buffer was allocated for the context block. This buffer has been 
lost through core clobbering or mismanagement of a buffer chain. The particular user cannot 
continue. 



Code: 2D-01 

Called From: COOP 

Message: SYMBIONT/COOP FILE DEVICE INACCESSIBLE 
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Registers: 


- -- -■■ — ■■ - — ■ - - - -- r"r\ — 

RO ' - COOP+ J9B. 

Rl - Context b'pck physical address. 

R4 - (DCT3(DC7X))wi1i appear in the format XXIX XXXX, 

SR4 - COOP + .15C. 

Dl - .XXFF0300 + DCTX (X means could be any value). 

D2 - BA (COOP BUFFER). 

D3 - .400. 

D4 - Disk address. 


Remarks: 


The symbiont/coop file device containing this user's file is down. If there are many file devices for 
symbiont/coop only, this user should be aborted. If only one symbiont/coop file device exists, it is 
pointless to run the system with that device down. 


Code: 2D-02 




Called From: 


COOP 


Message : 


USERS COOP CONTEXT BLOCK CHAIN LOST 


Registers: 


Rl - BUFLIMS index for screech code 19. 

R2 - .BC10. 

SR2 - OPNLD + .137. 

SR4 - OPNLD + .139. 

D3 - 0. 


Remarks: 


Similar to 2D-00 but detected at context block open time. Particularly alarming because this check 
immediately follows the code which allocates context blocks. 


Code: 2D-03 




Called From: 


SACT 


Message: 


COOP CONTEXT BLOCK POINTERS CLOBBERED 


Register: 


R3 - 0. 

R6 - User DCB address. 

SRI - FCN in leftmost 8 bits; DCB address in rightmost 24 bits. 

SR4 - Exit from COOP. 


Remarks: 


Either J:USCDX or context block (special pointers) were clobbered. 


Code: 20-04 




Called From: 


SUPCLS 


Message: 


COOP DATA BUFFERS MISALLOCATED 


Registers: 


D3 - Buffer being released, including spare buffer index in byte 0. 

R5 - Context block address and DBPOOL which i$ the address of the free context buffer list. 

R2 - SV:LS1Z. 

SR4 - Return address to caller of RCBUFF. 


Remarks: 


An attempt was made to releasee* COOP data buffer when the free data buffer pool was full. Either 
the free data buffer pool has been clobbered or too many buffers have been allocated meaning some 
other COOP data area has been clobbered. 
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Code: 2E 
Called From: 
Message : 
Registers: 

Remarks: 



RDF 

POOL BUFFERS LOST -NONE ALLOCATED CURRENTLY 

SR3 - DCB address for which buffer is needed. 
D4 - X'2E'. 

An attempt was made to get an IPOOL or FPOOL buffer but none were in the free pool and no 
open DCB had any. Probably either the DCB chain has been clobbered or one or more DCBs have 
been clobbered. 



Code: 2E-01 

Called From: RA 

Message: INCONSISTENCY IN READ-AHEAD TABLES 

Registers: R12 - Disk address. 

Remarks: An attempt was made to add an AIR block to the tables when it was already there. 



Code: 30 
Called From: 
Message : 
Registers: 
Remarks: 



PFSR 



UNBALANCED POWER ON/POWER OFF INTERRUPT PAIRS 



Unbalanced power on/power off interrupt pairs, more of one than another (usually power on, or else 
system would hang in waif; i.e., B $-1). 



Code: 31 
Called From: 
Message: 
Registers: 
Remarks: 



GERM 

INVALID RESOURCE TYPE 

SR4 - ADDRESS + 1 where discovered. 

Invalid resource type found. 



Code: 32-00 

Called From: IOQ 

Message: DCB DOESN'T CONTAIN A VALID DCT INDEX 

Registers: R2 - Address of DCB. 

Remarks: The DCT index is not present in DCB. 
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Code: 34-60 
Called From; 
Message: 
Registers: 
Remarks: 



TPQ1 

TRANSACTION PROCESSING FAILURE 



The System Queue Manager for transaction processing has discovered an unrecoverable state while 
processing transactions. 



Code: 37-00 

Colled From: ENQUE 

Message: ENQ/DEQ TABLES MALFORMED 

Registers: Depend upon how EQSCOO was called. See Code. 



Code: 3B-00 

Called From: OUTSYM 

Message: OUTSYM ATTEMPTED I/O ON A MISSING OR DOWN DEVICE 

Registers: R14 = Disk address in error . 

Remarks: The disk address passed to OUTSYM Is either garbled or refers to a down device. OUTSYM cannot 

continue with this file. 



Code: 41-01 
Called From: 
Message : 
Registers: 

Remarks: 



RTROOT 

FAILED TO FIND USER'S STATE (M:INTSTAT) 

R2 - Address of ICB being checked. 

Probably results from a state having been added to SCHED without updating the four masks used by 
the M:INTSTAT routine (WAIT:MASK, EXU:MASK, !OWAIT:MASK, BLCKD:MASK). 



Code: 41-10 
Called From: 
Message: 
Registers: 

Remarks: 



RTROOT 

BAD IOEX CALL TO NEWQ 

SetforBALR,11 NEWQNW. 

NEWQNW returned to BAL + 1. 
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Code: 4t-H 






Called From: 


•RTNR 




Message: 


UNABLE TO RETURN PRE-EMPTED DEVICE 




Registers: 


- 




Remarks: 


RTNR's call to RMAOV was invalid. 




Code: 43-01 






Called From: 


CLOCK4 




Message: 


NO ICBS CHAINED INTO RTICBCLKHDR 




Registers: 


- 




Remarks: 


This is probably caused by overwriting lowcore. 




Code: 43-02 






Called From: 


CLOCK4 




Message: 


ICBCLK FIELD OF ICB NEGATIVE 




Registers: 


R2 - Address of bad ICB. 
RIO - Current timer increment. 




Remarks: 


The ICBCLK field of an ICB should never go negative. 




Code: 43-03 






Called From: 


RTNR,CLOCK4 




Message: 


NO BACK-LINK FOUND IN DE-CHAINED ICB 




Registers: 


R2 - Current ICB (the one being de-chained). 
R4 - Forward link (next ICB in chain). 




Remarks: 


A back-link of zero implies that the current ICB is SYSICB1 (the 
should never be de-chained (i.e., de-activated). 


1 -second CLOCK3 ICB). This ICB 


Code : 46-21 






Called From: 


PV 




Message : 


PRIVATE VOLUME LOGIC INCONSISTENCY 




Registers: 


SR4 - Address where error was detected. 




Remarks: 


Numerous modules call PVERR. 
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Code: 49 
Called From: 
Message: 
Registers: 

Remarks: 



TYPR 

RESOURCE PREALLOCATION INCONSISTENT WITH REQUESTS 

R3 - 0. 

R3 - Reel number. 

D4 - X'49'. 

The user was preal located the resource (according to his Job context), but when the system got to 
the point of actual allocation, it found that none of that resource was available. Either the job 
context specifying preal location is damaged or the system context recording actual allocation is 
damaged. 



Code : 56 
Called From: 
Message: 
Registers: 
Remarks: 



MOCIOP 

UNABLE TO RELEASE PHYSICAL WORK PAGE 

The registers at the time of the trap. 

Originates in the MOCIOP module when unable to release a physical work page locked .in core 
during transaction processing ]/0 on a message-oriented controller (e.g., 7605). 



Code: 60-00 
Called From: 
Message: 
Registers: 
Remarks: 



TEL 

TEL ISSUED SINGLE USER ABORT ON YOU 

R15 - Subcode. 

The user already has SBUFI at entry to TEL. This software check indicates a problem in memory 
management of physical pool pages. 



Code: 80-01 
Called From: 
Message: 
Registers: 
Remarks: 



TEL 



TEL ISSUED SINGLE USER ABORT ON YOU 



TEL failed to get SBUF2 to read the assign/merge record. This software check indicates a problem 
in memory management of pool pages. 



Code: 60-02 

^ oiled Frc TEL 



Message : 
Registers: 
Remarks: 



TEL ISSUED SINGLE USER ABORT ON YOU 



TEL failed to get SBUF2 for a GET. This is essentially the same as software check 60-01 (failed to 
get SBUF2 for READAM). A TEL logic problem or memory management failure is indicated. 
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Code: g$-83 
Called From: 
Message: 
Registers: 
Remarks : 



1 



TEL 

TEL ISSUED SINGLE USER ABORT QN YOU 

SR4 - Contents of AM :LNK. 

The assign/merge record is inconsistent with a user in the command file mode. AM:LNK (in the 
assign/merge record) should always point past the command file information, and it doesn't. 



Code: 80-04 
Called From: 
Message: 

Registers: 
Remarks: 



TEL 

TEL ISSUED SINGLE USER ABORT ON YOU 

SR2 - The virtual page address through which TEL was trying to SAD (M:CVM). 

This software check indicates a problem in memory management or a logic problem in TEL which 
caused the user's map to be left "dirty" from a previous SAD (M:CVM). 



Code: J51 - (Trap Cell) 

CaUeaSrom: IN1TRCVR 

Message-,; TEL OR CCI HAS TRAPPED 

Register Registers at time of trap. 

Remarks - : 



Tfoe trap occurred while operating mapped, slave, and with TEL-in-conrrol set. The subcode is 
♦he trap location. 



Code: 82 

Called From: 
Message : 
Registers: 

Remarks: 



SCHED 

USER PROGRAM TOO LARGE FOR PHYSICAL MEMORY 

RO - Pages freed. 

R4 - Inswap user (S:ISUN). 

RO > SL:CORE. User got swapped out but now can't fit back in. Pages may be released but not re- 
ported. The JIT in-core flag = 0. (UH:FLG X'200'.) 



Code: 63 

Called From: 
Message : 
Registers: 



Remarks: 



DPSIO 

INSUFFICIENT INFORMATION AVAILABLE TO SWAP THIS USER 

R2 - IOCD. 

R6 - Command list address. 

R7 - Function code. 

D4 - X'63'. 

Insufficient data to complete function, follow-on function code invalid, or flags not set properly. 
(Disk pack-only swappers. ) 
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Code: 6A 


* 


Called From: 


MM 


Message : 


ATTEMPT TO RELEASE VIA M:CVM FRQM USER W/O PROPER PRIVILEGE 


Registers: 


Rl - X'80'. 

R5 - Address of top of dynamic data or bottom of command. 

R6 - Number of pages to release. 

R7 - Virtual page number. 

SRI - Number of pages released. 

SR2 - First page to release. 

SR3 - Increment or decrement to next page . 

SR4 - Link. 

Dl - CC. 

D2 - CC mask. 


Remarks: 


Virtual page outside of user's area (BUP-EUP) was obtained by an M:CVM CAL, but the user lacks 
required privilege (X'80 1 ) to release it. 


Code: SB 




Called From: 


MM 


Messages: 


ERROR IN SPARE BUFFER TABLES 

i ■ • 


Registers: 


fill - Address in buffer subroutine within MM (T:GBUF, T:RBUF, etc.) which detected the error. 


Remarks: 


Usually due to bad input from the calling routine. 


Code: 6B 




Called From: 


SWAPPER 


Message: 


ERROR IN SPARE BUFFER TABLES 


Registers: 


R6 - BA (window page). 

R14 - Physical page assigned to window. 


Remarks: 


Page mapped into window is not contained in the spare buffer pool. 


Code: 78-00 




Called From: 


MPSCED 


Message: 


SLAVE CPU INVOKED CRASH 


Registers: 


R15, left halfword: Screech code passed by slave CPU. 
R15, right halfword: Slave CPU's processor number. 


Remarks: 


A slave CPU encountered a condition that requires a full system recovery. 
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Code: 7801 
Called From*. 
Message: 
Remarks: 



ENTRY 

SLAVE CPU TRAPPED WITH NO USER ASSOCIATED. 

A slave CPU suffered a trap (or issued a CAL) with no user associated. 

If this situation occurs, the system will screech with a code of 78-00. The value X'780100nn' will 
appear in the master CPU's R15 at the time of the crash ("nn" being the slave CPU's processor 
number.) 



Code: 78-7F 
Called From: 
Message: 
Remarks: 



MPSUB 

MASTER CPU WANDERED INTO SLAVE CPU'S CODE 

The master CPU somehow began executing code reserved for the slave CPU(s) in a multiprocessor 
system. 



Code: 79 
Called From: 
Message: 
Registers: 
Remarks: 



ENTRY 

Monitor committed a stack trap 

Registers at time of trap 

Master bit on in PSD, overflow, underflow, or pointer to stack lost, 



Code: 7S-01 

Called From: 
Message: 
Registers: 
Remarks: 



T:OV 

MONITOR STACK TRAP 
Registers at time of trap. 
OSTACK overflow. 



Code: 79-02 

Called From: 
Message: 
Registers: 
Remarks: 



Code: 7C 

Called From: 
Message: 



S5SIM 

SIMULATORS COMMITTED TSTACK OVERFLOW 

None . 

This user has too many environments on his stack to simulate a non-existent instruction on a 
Sigma 5 only. 



ALTCP 

ALTCP CALLED TO SERVICE A CAL THAT DOESN'T BELONG TO ALTCP 
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Registers: 
Remarks: 



None 



ALLOCAT dates (HGPs and TABLES) has been destroyed. 



Code: S3 
Called From: 
Message: 
Registers: 

Remarks: 



DPSIO, TSIO 

TDV COMMAND ADDRESS DOESN'T POINT TO COMMAND LIST 

Rl - 0. 

SRI - Command list address from TDV. 

SR2 - TDV status. 

D2 - Command list pointer (S:BECL,R1). 

IOP/memory failure; extraneous entry to TSIO/DPSIO not generated within CLIST. 



Code: 94 
Called From: 
Message : 
/Registers: 

Remarks: 



DPSIO, TSIO 

COMMAND LIST CLOBBERED DURING WRITE CHECK 

SRI - Incorrect command list entry address. 

SR2 - TDV status. 

R12 - Order code from incorrect command list entry. 

Can't find seek or TIC within next five command list entries following error entry on write Or write 
check. 



Code: 95 
Called From: 
Message : 
Registers: 



DPSIO, TSIO 

UNRECOVERABLE I/O ERROR READING USER'S JIT. 

Rl - Inswap user number (S:ISUN). 

R7 - DCT index. 

SRI - Command list address from TDV status. 

SR2 - TDV status. 



Code: 96 

Called From: 
Message : 
Registers: 



DPSIO, TSIO 

UNRECOVERABLE I/O ERROR READING SHARED PROCESSOR 

Rl - Inswap user number (S:ISUN). 

R7 - DCT index. 

SRI - Command list address from TDV status. 

SR2 - TDV status. 
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fable C-l. CP-V Software Check Codas (coot.) 


Code: FF-QO 




Called From: 


BOOTSUBR 


Message: 


OPERATOR INITIATED RECOVERY 


Registers: 


RO - 11 (Sigma 5,6,7) 

- 15 (Sigma 9) 
Rl - unchanged or 


Remarks: 


Called from BOOTSUBR on a boor from disk when sense switch 3 is set. 
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Registers: R3 - Register field of CAL. 

R6 - First word PLIST. 

R7 - Address of PLIST + 1. 

SRI - Code. 

SR4 - Exit address (usually TRAPEXIT). 

Remarks: A CAL1,1 or CAL1,2 was passed to ALTCP but should have been handled by CALPROC. 



Code: 7E - (Trap Cell) 

Colled From: INITRCVR 

Message: MONITOR HAS TRAPPED 

Registers: Registers at time of trap. 

Remarks: Subcode is trap location. For traps that occur at locations less than X'8000' (JOVVPA), the 

15 cells preceding the trap location and the trap location are stored in the monitor JIT at 
X'8DFO' - X'8DFF'. 



Code: 87 
Called From: 
Message: 
Registers: 

Remarks: 



ALLOCAT 

ALLOCATION BUFFERS CONTAIN INVALID WORD COUNT 

Rl - Stack number. 
R2 - Stack count. 

Either low core has been clobbered or someone has changed ALLOCAT's in-core data. 



Code: 88 
Called From: 
Message: 
Registers: 

Remarks: 



SCHED 

ALLOCAT CLOBBERED ONE OF THE ALLOCATION BUFFERS 

R1 - Stack index. 
R3 - Stack count. 

ALLOCAT end-action has discovered a discrepancy in the granule/cylinder stacks. 



Code: 89-00 
Called From: 
Message : 
Registers: 

Remarks: 



ALLOCAT 

ALLOCAT'S HGP CHAIN CLOBBERED 

R7 - Invalid HGP chain address. 

R9 - ALLOCAT internal link register. 

ALLOCAT data (HGPs and TABLES) hat been destroyed. 



Code: 89 '*? 

Called From: ALLOCAT 

Message: DATA CHECKSUM ERROR 
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'FEUDiX D. 



m 



ASSIST STATION 



INTRODUCTION 

The Remote Assist Station (RAS) and the associated routines 
comprise the CP-V interface for on-fine remote assistance 
for both software and hardware analysts. This facility pro- 
vides an on-line connection to the operating system without 
requiring the use of any of the normal communications 
equipment. The RAS user has access to ELLA for listing and 
analyzing the contents of the system error log file (ERRFILE) 
and to ANLZ and Delta for examining crash dumps and the 
running monitor. 



HARDWARE INTERFACE 

The Remote Assist Station may be any ASCII terminal cap- 
able of connecting to the provided data set (Bell 103A or 
its equivalent). The data set is connected to the Remote 
Channel Interface of the System Control Processor. (See 
the Xerox >; 560 Computer Reference Manual, 90 30 76.) 
To use the interface on-line, the REMOTE CHANNEL 
switch on the Xerox 560 System Control Panel must be in 
the J/O position. This connects the remote channel to 
address X'OB' on the MIOP in cluster zero, through which j 
the CP-V interface communicates. This address must be 
SYSGENed as the Maintenance Control (MC) device. The 
hardware performs character translation from ASCII to 
EBCDIC (and vice versa) to make the terminal appear as 
an EBCDIC device. The translation tables are depicted in 
Table D-l. The left side of the table shows standard ASCII 
characters. The corresponding entries in the, right side of 
the table show EBCDIC translation. 



— OM9T=T© (required for mounting tape dumps) 

.— © .. 

-END© 

LOGON verifies the OMMC authorization before it ac- 
cepts the account and name, and will not allow the user to 
log on if he does not have this resource authorization. 

If the user's account and name are accepted, the user is 
logged on as a non-COC on-line user and LOGON exits to 
TEL which issues a prompt for Input (I). 



PROCESSOR teSTRIGTOS 

The MC authorization causes a :PROCS entry to be created 
for the RAS user which restricts him to the following list 
of processors: 

ANLZ 

Delta 

ELLA 

No other processors or programs are allowed at the RAS. 
Except for these processor restrictions, TEL will accept most 
of its commands (e.g., SET, PRINT, MESSAGE, QUIT, 
GO). However, commands regarding terminal type and 
status will be ignored. 



SOFTWARE INTERFACE 

CP-V provides an on-line communications interface enab- 
ling the remote analyst to log onto the Maintenance Console 
much as if he were connected to a COC terminal line. The 
interface is initiated at the Operator's Console (OC) by a 
special form of the GJOB key-in after the RAS is connected 
to the dial-up modem: 

1GJOB LOGON, MC 

This key-in causes LOGON to print a salutation to the MC 
resource requesting the RAS user to enter his account and 
name. The RAS user must be explicitly authorized via Super 
to use the MC resource. The following is an example of 
such a Super authorization: 

-C RAS, ASSISTANCE © 

— O$PR=A0 © (required for running diagnostic 
programs) 

— OMMC=l© (authorizes on-line use of the MC 
resource) 



COSiJJUNlCATIQNS RESTRICTIONS 

The communications link to RAS uses a small resident 
handler in conjunction with the hardwired micro-coded 
controller to provide a terminal interface. Due to the 
limitations of the hardware and size restrictions on the 
software handler, some compromises have been made. The 
following list outlines the major characteristics of the com- 
munications interface: 

1. The MC device is a message mode device, requiring 
either LINE FEED, RETURN, CONTROL X, or CON- 
TROL H to end each input. LINE FEED and RETURN 
generate an X'15' (NL) character. CONTROL X and 
CONTROL H generate an X'08' (EOM) character which 
is used to cancel an input line so that the line may be 
retyped. 



2. Although the RAS terminal is connected in full-duplex, 
the MC device operates in half-duplex, echoplex 
mode, allowing I/O transfer a line at a time in only 
one direction. When a read is pending, characters 
typed will be echoed to the print mechanism of the 
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Table D~l. 'ASCII to EBCDIC Translate Table 



! — * r^ : : — : 


• ./ .,".:.' EBCDIC 







1 


2 


3 


4 


5 


6 


7 




. 


• 1 ■; ■ 


. 2 


3 


4 


5 


6 


7 





NUL 


DLE 


SP 





@ 


P 


\ 


P 





.NU.I /■ 


DIE y^ 
/10 


SP y^ 
/ 40 


x/ 
/F0 


© 


P >/ 
/\>7 


/4k 


P / 

7D7 


1 


SOH 


DC1 


1 


1 


A 


Q 


a 


q 


I 


SOH >/ 

/o\ 


DC1 // 

/ 11 


! y^ 

/5k 


1 y/ 


A y^ 
/ & 


Q y^ 


k®/ 

x Ci 


Q y^ 

/OS 


2 


STX 


DC2 


- 


2 


B 


R 


b 


r 


2 


SIX/ 
/Q2 


DO/ 


II .y 
/I* 


2 ./ 
y/ F2 


B y^ 
/ 0.2 


R y^ 
/W 


B >/ 
/CI 


R y/ 

/09 

/ ... ... ^ 


3 


ETX 


DC3 


# 


3 


C 


S 


c 


s 


3 


UX / 
/ 03 


DC3 >/ 


/7l 


3 >/ 


C y/ 

/ C3 


S >/ 
/V2 


C / 
/Q.Z 


S // 
/Z2 


4 


EOT 


DC4 


$ 


4 


D 


T 


d 


t 


4 


EOT / 
/04 


DZ4 / 


$ /^ 

/ 5* 


4 y/ 
y^ F4 


D ^/ 


xi 


V / 
/C4 


'X 


5 


ENQ 


NAK 


% 


5 


E 


U 


e 


V 


5 


enq/ 

/W 


ukK/ 

/Ok 


% y/ 

/ 6C 


5 y^ 
/ *5 


E y^ 
y^ C5 


v/ 

/14 


I / 

/Q.5 


U y/ 


6 


ACK 


SYN 


& 


6 


F 


V 


f 


V 


6 


© 


SYN/ 
/16 


/ 50 


6 / 
/ F6 


F ^/ 

y^ C6 


V / 
/tt 


$ / 
/ Cb 


v >/ 

y/ E5 


7 


BEL 


ETB 


/ 


7 


G 


W 


Q 


w 


7 


BEL y^ 
/ VI 


ETB /^ 
/ M 


/TV 


7 y^ 
y^ F7 


Q/ 
/ C7 


Vi / 


Q,/ 
/ 7 


w/ 

/ E6 

y 


8 


BS 


CAN 


( 


8 


H 


X 


h 


X 


8 


© 


© 


( y/ 
/ 4V 


/ F8 


/ C8 


Y./ 
/ C7 


W/ 
/ c8 


X /^ 
/ & 


9 


HT 


EM 


) 


9 


I 


Y 


i 


y 


9 


W\ / 
/ 05 


em/ 

/^ 19 


) / 
/ 5D 


9 y' 
>/ F9 


\ / 
/ C9 


Y/ 
/ E8 


\ / 
/ C9 


Y // 
/^ E8 


A 


LF 
NL 


SUB 


* 


: 


J 


Z 


i 


z 


A 


NL/' 


SUB / 


/ 5C 


/7k 


J ^/ 
/ *>\ 


/V) 


i / 
/V\ 


Z y^ 
/ & 


B 


VT 


ESC 


+ 


; 


K 


[ 


k 


{ 


B 


VT y^ 
/ (to 


ISZ / 
/ LB 


+ / 
/ E 


/ 5E 


K / 
/ D2 


1 y/ 

/ & 


K/ 
/V2 


/ B2 


C 


FF 


FS 


' 


< 


L 


\ 


1 


1 
1 


C 


FF >/ 

/sz 


FS y^ 
/1C 


> / 

/ t& 


< y^ 
/ 4Z 


L y/ 

/ vz 


/Ak 


V / 

/vz 


1 y^ 

/** 


D 


CR 


GS 


- 


= 


M 


] 


m 


} 


D 


NL >/ 
/\5 


GS >/ 

/lD 


/ $> 


/ 7E 


*A / 
/ VA 


—i -y 
y^ 5F 


y / D4 


/ te 


E 


SO 


RS 


• 


> 


N 


- 


n 


- 


E 


SO ^/ 


RS >/ 

/lE 


/ B 


> / 

/ 6E 


/ 5 


/s ^y 
/6A 


H/ 
/V5 


/ & 


F 


SI 


US 


/ 


? 


O 


- 


o 


DLE 


F 


SI y^ 
/OF 


US ^z 
/lF 


/ / 
/ 61 


1 / 
/ & 


O / 
/ Vb 


/(£> 


O/ 
/Vb 


/ ih 


Notes: (T) 


Used by Diablo Centaur terminal EOT/ACK protocol. 
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terminal. If a read h not pending, chcruo*&;> typed 
are not echoed and are ignored. 

3. The BREAK key nay be depressed at any time to in- 
dicate a BREAK signal. The MC Handler causes a 
BREAK event to be issued tor the user end counts,suc- 
cessive BREAKs. If the user issues four successive 
BREAKs, the handler causes a CONTROL Y event, 
(i.e., an escape to TEL). The BREAK key cancels any 
current I/O operation to the terminal. 

4. In order to detect line drop or disconnect, input re- 
quests will time out in three minutes and output mes- 
sages will time out in 20 seconds. A failure to respond 
to a read within three minutes causes the RAS user to 
be logged off. 

5. Records output to the RAS terminal have a maximum 
size restriction of 140 bytes. Trailing blanks in an 
output record are suppressed by the MC handler. Rec- 
ords output through DCBs other than M:UC have a 
RETURN/LINE FEED appended to them. Records writ- 
ten through M:UC must contain their own carriage 
control characters. 

6. The MC handler does not simulate tabs nor does it 
affect pagination. 



7. irtdividupj charactetj inoy be erased on input by typm 
@ characfers f®r each character, to be erased (e.g., 
'ANE@LZ' results in "AN LZ'). Complete lines may 
be erased by endjng Jkj line wi*h CONTROL X or 
CONTROL H which causes - the handler to echo 

and td reissue the reed that was in operation. 

8. End-of-file condition is set upon receipt of the three 
character sequence CONTROL F0. 



9. Lower case letters are echoed in lower case but are in- 
put to the program as upper case. 

10. When Delta issues a read, special action takes 
place by the handler to simulate the Delta activa- 
tion character set. Special Activation characters 
(CONTROL I , ) = /) should be immediately fol- 
lowed by a RETURN or LINE FEED. For commands 
which usually end with a RETURN, either a RETURN 
or a LINE FEED is valid. Commands v/hich normally 
end in LINE FEED should be ended with CONTROL X 
or CONTROL H. Line erasure is effected by ending 
the line of input with ? RETURN. 
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APPENDIX E. ERRFILE FORMATS 



ERRFILE is a keyed file built and updated by ERR:FIL for 
use by diagnostic programs. The file contains one record 
for each error entry in the file created by ERRL0G, 

The keys for this file contain the Julian date in packed 
decimal, the time of the error in EBCDIC/ and a sequence 
number for errors with the same time tag^ This sequence 
number is reset to zero for each entry with a new time tag. 
The format of the key is 



yyOddd is the Julian date in packed decimal, 

hhmm , is the time (hours and minutes) in EBCDIC, 
n is the sequence number. 



The first record of ERRFILE is the key of the last record in 
ERRFILE and has a key of zero. 



08 


yy 


0d 


dd 


h 


h 


m 


m 


n 









where 

08 is the number of bytes in the key. 



While copying records into ERRFILE, consistency and error 
checks are made on the input data. If any errors or in- 
consistencies are found, "copy error" records are written 
and a "copy error" counter in the summary record is in- 
cremented. The error and consistency checks, recovery 
actions taken, and the format of the copy error records are 
described below. The terminology used in the error record 
formats is defined in Table E-l. 



Table E-l. Error Record Terminology 



Term 


Meaning 


Account 


The doubleword used to identify a user's collection of files. 


AIO CC 


A 4-bit field representing the condition codes as returned by the hardware 




in response to an AIO instruction. 


AIO Status 


A 16-bit field representing the status as returned by the hardware in response 




to an AIO instruction. 


Alternate I/O Address 


A 16-bit value representing an alternate physical I/O address by which a 




dual-access device can be referenced. 


Bytes Remaining 


A 16-bit field representing the Remaining Byte Count (RBC) field as returned 




by the hardware in response to a TDV instruction. 


Consecutive, Keyed, Random 


Methods of organizing user files in CP-V (refer to the CP-V/BP Reference 




Manual, 90 17 64). 


Count of Entries Identical to 


The number of error log records which are identical to one previously logged 


Previous Entry 


for identical reasons (excludes time records). 


Count of Entries Lost 


The number of error log records lost when logging becomes temporarily im- 




possible for any reason. 


Current Command Doubleword 


A 64-bit value representing the command doubleword currently being pro- 




cessed for a device (indicated by the TDV status DW). 


CPU Address 


Hardward address of CPU performing the function (meaningful only for 




multiprocessing). 




Sigma 6 and 7—0 




Sigma 9 — port number 




Xerox 560 — basic processor address 
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Table E-l. Error Record Terminology (cent. ) 



Term 


Meaning 


Caller's Address 


• The address back to which the error logging routine is returned when logging 
is complete; used in isolating software faults. 


DCT Index 


The 8-bit value indicating the order in which the device is configured into the 
system (at SYSGEN). 


DCT Index of Symbiont Device 


The 8-bit value indicating the order in which the device associated with the 
symbiont is configured into the system (at SYSGEN). 


Effective Address 


A 32-bit value representing the final address computed for the instruction 
pointed to by the instruction address (IA) in the PSD. 


Error Subcode 


An 8-bit field indicating which of several types of file inconsistencies has oc- 
curred (see CP-V/BP Reference Manual, 90 17 64). 


File Name 


The TEXTCname used to identify a collection of user data on secondary storage. 


Granule 


The unit of secondary storage allocation equal to 2048 bytes (usually 2 sectors). 


HIO CC 


A 4-bit value (bits 0-3 of designated byte) representing the condition codes as 
returned by the hardware in response to an HIO instruction. 


HIO Status 


A 16-bit value representing the status as returned by the hardware in response 
to an HIO instruction. 


J/O Address 


A 16-bit value representing the physical l/O address. 


I/O Count 


A 32-bit value representing the number of SIO instructions executed for the 
device. 


Julian Day 


A 16-bit value representing the Julian day of the year (e.g., March 1 would 
be represented as X'3D') when the error was logged. 


Length 


A 8-bit value in the second byte of the error log record representing the num- 
ber of useful 32-bit words contained in the error log record. It includes the 
first word in the count. 


LMSCC 


The condition codes obtained when fetching a location via an LMS (Load Mem- 
ory Status) instruction. The condition codes indicate whether or not a parity 
error occurred during the fetch. 


Memory Status Words 
(Sigma 9 only) 


Each word is a 32-bit value representing data returned by the hardware in 
response to an LMS instruction. 
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Table E-I. Error Record Terminology (cont. } 



Term 


Meaning 


MFI (Sigma 6 or 7 only) 


A 4-bit value representing the current state of the memory fault indicators 
returned by the hardware in response to an RD instruction. All memory fault 
indicators will be reset. 


Mode 


A 16-bit value representing the manner in which the file was last referenced 
(see CP-V/BP Reference Manual, 90 17 64). 


Model Number 


A 16-bit value representing the model number assigned by Field Engineer- 
ing to uniquely identify peripheral devices (e.g., 7242 would be represented 
as X'7242"). 


Number of Parity Errors 


A 16-bit value representing the number of bad locations causing memory parity 
errors (only the first 14 bad locations are entered in the log if the number of 
errors is greater than 14). 


Primary I/O Address 


A 16-bit value representing the physical I/O address by which a device can 
be referenced (see Alternate I/O Address). 


PSD 


A 64-bit value representing the program status doubleword. 


Real Address 


A 32-bit value representing the actual memory address (in a mapped system, 
this is the same as the address in the IA field of the PSD). 


Recovery Count 


An 8-bit value initialized to zero at system initialization and incremented by 




the value one for every system recovery. 


Relative Sector Address 


A sector is 256 words. Each sector on a gfven device is numbered zero through 
device end. CP-V maintains file pointers by "relative sector number, thereby 
simplifying the logic necessary to addfe*ss .different devices. 


Relative Time 


A 32-bit value representing milliseconds since midnight. Resolution is 2 msec. 


Relative Time Resolution 


An 8-bit value, n, such that actual relative time resolution = 2 msec, (e.g., 
n = 1 for a resolution of 500HZ or 2 msec. ). 


Retries Remaining 


An 8-bit value representing Retry Request minus the number of entries at- 
tempted. The range is between Retry Request and -I. A value of -1 indicates 
the operation was terminated due to retry count rundown. 


Retry Request 


An 8-bit value representing the maximum number of retries after which a device 
error is returned to the requester. This value is obtained from the requester's 
DCB. 


Screech Code 


The code used by CP-V to identify the system failure which has occurred. 
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Table E-l. Error Record 'Terminology (conf. ) 


Term 


Meaning 


Screech Subcode 


An 8— bit field identifying which type of a specific and similar set of system 
failures has occurred. , (See Software check codes in the CP-V/OPS Reference 
Manual, 90 16 75.) 


Seek Address 


The physical disk address last used to access this device. 


Sense Information 


The diagnostic information returned from the device as a result of sending a 
"sense" order to the device. 


SIO cc 


A 4-bit value (bits 0-3 of designated byte) representing the condition codes 
as returned by the hardware in response to an SIO instruction. 


SIO Status 


A 16-bit value representing the status as returned by the hardware in response 
to an SIO instruction. 


Site Identification 


A 64-bit field containing the site ID from the SYSGEN :MON card left Justi- 
fied with blanks on the right. 


> Slarfwp Type 


An 8-bit field indicating which of several types of system initialization was 
used. See the SYSTEM STARTUP error record (type X'I8'). 


Subchannel Status 


The status of the I/O subchannel received from the hardware as a result of a 
TDV instruction. 


Symbiont File 


A CP-V system special file for buffering data between. the CPU and slower 
speed line printers, card punchers, etc. 


TDV CC 


■ . 

* A,,4,-bif value (bits 0-3 of designated byte) representing the condition codes as 
rferurned by the hardware in respohse to a TIO instruction. 


TDV Current Command DA 


A 24-bit field representing the current command doubleword address used in 
obtaining the device status with a TDV instruction. 


TDV Status Doubleword 


A 24-bit field representing the subchannel status, as current command double- 
word, device status, and byte count as returned by the hardware in response to 
, a TDV instruction. 


TIO CC 


A 4-bit value (bits 0-3 of designated byte) representing the condition codes as 
. returned by the hardware in response to a TIO instruction. 


TIO Status 


A 16-bit value representing the status as returned by the hardware in response 
to a TIO instruction. 


Trap CC 


A 4-bit value (bits 0-3 of designated byte) representing the condition codes as 
returned by the hardware when certain traps occur. 
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Table E-l. Error Record Ter.mihofpgy-(conr. ) 



Term 


Meaning 


Trapped Instruction 


A, 32-bit value representing the contents ofthe location pointed to by the 
instruction address (IA) in the PSD. 


Type 


An 8-bit value in the first byte of the error record which identifies the type 
of record. 


Unifr Address 


A 6-bit value (bits 2 - 7 of designated byte) representing the address by which 
a processor can be referenced; the value is composed of a 3-bit cluster number 
followed by a 3-bit unit number. 


Unit Type 


An 8-bit value specifying the type of processor. Bit of the designated byte 
indicates the presence of the processor in the current operational configuration 
(0 = present, 1 = not present) . 


User ID 


A 16-bit value which is a unique number assigned by the system to the partic- 




ular job or on-line session. 


User Number 


An 8-bit value which is the index into internal system tables used to access 
user specific information. 


Version 


The version identifier of the system running (i.e., A00, BOO, etc.). This field 
is one byte in length. The letter of the version is stored in the first four bits 
and the number of the version is stored in the second four bits. 


Volume Serial Number 


A 4- or 6-byte field supplied by a user to identify either a tape or private 
pack. 


Year 


A 16-bit binary value representing the current year minus 1900 (e.g., 1973 is 
represented as X'49'). 



READ ERROR 

If the condition codes set by TrRDERLOG indicate a read 
error, a copy error record (Read Error) is written and copy- 
ing of the record is attempted. If inconsistencies are found 
in the record, a copy of the bad record is placed in the 
ERRFILE file, followed by the End Read Error record. If no 
inconsistencies are found, the record is processed normally 
and the Read Error record remains in the ERRFILE file. The 
record formats are 



End Read Error 
word 



Type 
X'10' 



Length 
X'02' 



I 2 314 S 6 718 9 10 TTT12 13 M 15116 17 18 19120 21 22 231 24 25 26 27128 29 30 31 



Subtype 
X'Q2' 



word 1 



Relative time 



i 2 3 14 S 6 7 Is 9 10 111 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 3 



Read Error 
word 



Type 
X'10' 



Length 
X'02' 



Subtype 
X'01' 



— f 2 3 t 4 5 6 7 18 9 10 111 12 13 14 15114 17 18 19120 21 22 23 ( 24 25 26 27U8 29 30 31 

word 1 



Relative time 



1 2 3 I 4 5 6 7 is 9 10 111 12 13 14 15 1 16 17 18 !9 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



ERRLCX3 RECORD LENGTH ERROR 

If the length ofthe ERRLOG record is greater than 64 words, a 
copy error record followed by the ERRLOG record is written 
on ERRFILE. No attempt is made to copy this record in the 
detailed format. The record format is 

word 



Type 
X'10' 



12 3 14 5 6 7 



Length 
X'03' 



9 10 11112 13 14 15 



16 17 18 19fkl 21 22 23 



Subtype 
X'Q3' 

S 26. 27 1 28 29 
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word 1 



Relative time 

8' I 1 3 h i 6 ? la t 10 H i 1^ 13 U H i lA I * IS iS i K) it 22 JftliV ' is U g l « K 36 5;' 



word 2 



Index to bad entry 



6 I J 3 I4 i 6 7 U 9 10 111 12 13 M 15ll6 17-18 19I2O 21 22 ll\u 25 26 v\t» 2* 30 3' 



INCORRECT TIME 

If the time of an entry is out of sequence, i.e., if it is 
earlier than the time of the last record and the data has not 
changed, a copy error record is written on ERRFILE followed 
by the ERRLOG record. The time of this entry is then used 
for the key and processing continues. The record format is 

word 



Type 
X'10' 



Length 
X'03' 



Subtype 
X'05' 



I 2 3 \* 5 6 7 Is 9 10 11112 13 14 lsl l« '17 18 1»T 20 21 22 231 24 25 26 27I26 29 30 31 

word 1 



Relative time 



IS 1 2 3 1 4 5 6 7 I 8 9 10 llll2 13 14 15(l6 17 18 '!9l 20 21 22 2i\ 24 25 26 27 1 28 29 30 31 



word 2 



Index to bad entry 



12 3 14 5 6 7 18 9 10 11112 13 14 15 1 16 17 18 19120 21 22 23124 25 26 27128 29 30 31 

where index is the displacement within the ERRLOG record 
of the first word of erroneous ent&y. 



ILLEGAL ENTRY TYPE 

If the entry type is not one of the legal types, a copy error 
record followed by the ERRLOG record is written on ERRFILE. 
No attempt is made to copy the remainder of the record. 
The record format is 



Note: Errors that occur while booting have a time teg cf 
24XX but the keys of these records contain'the cur- 
rent date and 0011 for the time.. 

If read or write errors are detected white reading or writing 
ERRFILE and SUMFILE, they are ignored. 

Whenever I/O errors or certain unusual conditions occur, 
an entry will be made into ihe ERRLQG file. This entry 
will contain any information ^pertinent to the condition. 

Word of each entry will have a code indicating which 
error or unusual condition is present along with the number 
of words in the entry (including word 0). Time (hhmm) and 
Device Name (yyndd) are in EBCDIC. 

There are no error log entries for the following two interrupts. 



MEMORY FAULT INTERRUPT 

The Memory Fault Interrupt (MFI) is triggered when an error 
is detected during a memory access by either the CPU or an 
IOP. If theMFIis triggered by the CPU, a parity error trap 
will also occur unless the error is a Loop Check Parity error 
or Overtemperature condition. The parity error trap routine 
performs error recovery, logs the error, and clears the MFI 
to avoid duplicate processing. The MFI service routine 
therefore expects to only handle errors detected during an 
IOP memory access and Loop Check and Overtemperature 
errors. The Loop Check and Overtemperature errors are 
processed by the memory parity program and the system re- 
covery program is entered with code X'23'. The other er- 
rors are logged by the device handler, which also performs 
the required recovery. 



PROCESSOR FAULT INTERRUPT 

The Processor Fault Interrupt is not enabled in CP-V. Errors 
that cause this interrupt in a monoprocessor system are han- 
dled by the I/O Interrupt Routines. 



SIO FAILURE 

This record is logged when CO and/or CC2 are set after 
execution of the SIO instruction. 



word 



Type 
X'10' 


Length 
X'03' 


■■■v.; '.;.;.|.m ■.■.;.;. .'.'".;.'■ i.--' : i 
< 


Subtype 
X'Qo' 


1 2 3 U 5 6 7 


8 9 10 111 12 13 14 15 


16 17 18 19120 21 22 23 


24 25 26 27 1 28 29 X 31 



word 1 



Relative time 



1 2 3 I 4 5 6 7 Is 9- 10 111 12 13 14 IS I 16 17 18 W 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



word 2 



Index to bad entry 

1 2 3 I 4 5 6 7 I 8 9 10 11 1 12 13- 14 isl 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 2B 29 30 31 



where index is the displacement within the ERRLOG record 
of the first word of erroneous entry. 



word 



Type 
X'll' 



1 2 3 14 5 6 7 



Length 
X'06« 



8 9 10 11112 13 14 15 



Model number 



16 17 IS 19120 21 22 23124 25 26 27T28 29 30 31 



word 1 



Relative time 



32 33 34 35 1 36 37 38 3>\*d 41 42 43 1 44 45 46 47 1 48 49 50 51 1 52 53 54 55 1 56 57 58 59 1 60 61 62 63 



word 2 



SIO status 



1 2 3 14 5 4 7l! 9 10 11112 13 14 15 



I/O address 

16 17 18 19l» 21 22 23l 24 25 26 27^8 29 X 31 
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word 3 



word 9 



,"MFI--(if 

S!gmg6'or : 7); 



SIOCG 



TDV CC 



1*~2 3 t< 5 i 7lt ,9 10. It'llFlj U 151 14 17 18 t»|j0 21 2? '23124 2i ?6 27I2S jT Ju 3 



word 4 



Subchannel 
status 



~ 



TDV current command DA 



i 2 3 I 4 5 6 7 1b" i 10 III 12 13 M 15ll6 17 18 )9l 20 21 22 23b* 25 26 27)28 29 30 31 

word 5 



TDV status 



i 2 3 I 4 5 .6 7 I 8 9 10 111 12 13 14 15 



TIME OUT 



Bytes remaining 



16 17 IB 19120 21 22 23 1 24 25 26 27128 29 30 31 



This record is logged when the I/O interrupt does not occur 
within a specified time period in response to an I/O 
instruction. 

word 



Type 
X'12' 



Length 
X'OD' 



Model number 



12 3(456 718 9 10 1 1 1 12 13 14 15 16 17 18 19(20 21 22 23(24 25 26 27128 29 30 31 



word 1 



Relative time 

1 2 3 1 4 5 6 7 Is 9 10 111 12 13 14 15! 16 17 18 19l» 21 22 23 1 24 25 26 27(28 29 30 31 



word 2 



HIO status 



1 2 3 14 5 6 7 18 9 10 111 12 13 14 15 



I/O address 



16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



word 3 








MFI (if 
Sigma 6 or 7) 


HIO CC 


TDV CC 


TIOCC 


12 3 14 5 6 7 


8 9 10 111 12 13 14 15 


16 17 18 19l20 21 22 23 


24 25 26 27l28 29 30 31 



word 4 



Subchannel 
status 



TDV current command DA 



1 23 14 56769 10 11)12 13 14 15116 17 IB 19(20 21 22 23(24 25 26 27(28 29 30 31 



word 5 








TDV status 


Bytes remaining 


1 2 3 1' 


5 6 7 U 9 10 III 12 13 14 IS 


16 17 18 19-120 21 22 23 1 24 25 26 27 1 28 29 30 31 



words 6 and 7 



Current command 
doubleword 



I U 5 6 7 Is 9 10 1)1 12 13 14 lsl 



123145 6 7189 10 1)112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



word 8 



TIO status 



request 

I 4 5 6 7 I 8 9 10 111 12 13 14 15116 17 18 19120 21 32 



Retry 



Retries 
remaining 



24 25 26 27l28 29 30 31 



• . •' ' ; . I/O count for this device 



1 2 3 4 4 5,6* 7 Is »9 10 111 12 13 14 15 < 16 17 IB I9I2O 21 22 23124 25 26 27 1 28 29 30 31 



words JO arid 11 



Volume serial number 

(Six characters for 
ANS tapes) 



Original 
function code 



0123(4567(89 10 11112 13 14 15116 17 IS 19120 21 22 23124 25 26 27128 29 30 31 



9(2 



Current 
function code 



word 12 



Seek address 



I 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15! 16 17 18 19 1 20 21 22 23 1 2-t 25 26 27 1 28 29 30 31 

UNEXPECTED INTERRUPT 

This record is logged when an interrupt, other than an at- 
tention interrupt, is received from a known device for - v 
which no I/O operations have been started by the system." 

word 



Type 
X'13' 

1 2 3 14 5 6 7 



Length 
X'.04' 



T89 10 11T12 13 14 15 



Model number 



16 17 18 "wl20 21 22 23124 25 26 27 1 28 29 30 31 



word 1 



Relative time 



I 8 9 10 111 



j 2314567189 10 11112 13 14 151 16 17 18 19120 21 22 23(24 25 26 27128 29 30 31 



124 25 26 27I2 



word 2 



AIO status 



I/O address 



T 2 3 I 4 5 i 7 Is 9 10 111 12 13 14 15M6 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



word 3 



rTY : W : W ; : 7 : 



AIOCC 



B 9 10 111 12 13 14 15 



WWW WW'^WiVfiT^'iVi^itiVi^ 



DEVICE ERROR 

This record is logged when general analysis of the status re- 
ceived from an AIO, TDV, or TIO indicates an error which 
resul ted from the I/O operation. For on-l ine diagnostic I/O, 
this information is returned in the STATUS area defined by 
M:DOPEN with the type code X'14' for normal completion. 

word 



Type 
X*15' 



Length 
X'OD' 



Model number 



I 23 14 567(89 10 1III2 13 14 15116 17 18 I9I2O 21 22 23 1 24 25 26 27 1 28 29 30 31 



word 1 



Relative time 



1 2 3 I 4 5 6 7 Is 9 10 111 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 X 31 
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word 2 



word 



AIO status 



I/O address 



t i i *U 5 t ;1» ? io nl'ii u i< Ijji* 17 it i»ljo ii 22 iili, Jj J» «l-ii y i4 5) 

word 3 



MFI (if 
Sigma 6 or 7) 



AlOCC 



TDVCC 



TIOCC 



I "i il< t t ill i 10 11I12 ij 14 is! i« i.' ii illji ji li }ll}4 is { 4 3>1 >* }» "SVT 

word 4 



Subchannel 
status 



TDV current command DA 



i"iiU 5 4 ifV'T ii'llln 13 14 isll4 17 It lt l fl 31 i} h l iV is 26 fr l it 2* 30 3l ' 

word 5 



TDV status 



Bytes remaining 



T"3 3 l« 5 6 7 It 9 10 III 12 13 14 15116 17 It l»l» 21 22 Zl\u 25 26 27 1 20 29 30 3 



words 6 and 7 



Currant command 
doubleword 



"1 )|4 i 6 7 It « 10 111 12 13 14 15 1 16 17 II !»l?0 21 22 23! 24 25 24 27 1 28 2? 30 



Type 

X'16' 

v "i -vn , i , "4 , "> 



word .1 



Length , 

(va riable) 

1 frits iu ij u i« is 



I/O address 

14 17 l« l«l'20'|l 22 23 1 24 21 24 2/1 21 2* X> 



.Relative time 



H — I ) Sli St jtl » 10 111 12 II 14 isllt I' II l»ljO 21 72 23l24 25 26 2>l« 79 X V 



words 2 and following 



Sense information (left justified) 
Device Length (m bytes) 


7242 10 
Disk A # B 16 


1600 bpi tape 6 
9T tape 1 





IVMU O 

2 jU 5 t 7ll « 10 III 12 1} 14 I5ll6 17 It 19120 21 22 23 1 24 25 26 27 1 2B 29 30 31 



The I/O address links the secondary record to the cor- 
responding device error entry. 



word 8 



TIO status 



Retry 
request 



Retries 
remaining 



» i 3 >U s 4 Hi * i s n t ij ii li is ) it i7 ii mltoi a mwu i* » \ n a m i ' 



word 9 



l/O count for this device 



"l ) ]l< ~ 6 7 It 9 10 tll-12 13 14 15 lift 17 II 19 1 20 21 22 23(24 25 26 27 1 78 TV 30 ] 



words 10 and 1 1 



Volume serial number 



(Six characters for 

ANS topes) 

"1 2 Tt"4 5 4 7 It 9 10 111 12 13 14 IS 



Origina 
function code 



16 17 II 19(20 21 22 23 



Current 
function code 



24 25 26 27138 29 30 31 



SYSTEM STARTUP 

This error is logged at system initialization and at every 
recovery. 

word 



X' 



Length 
X'04' 



Startup 
type 



Recovery 
count 



I 1 3X4 5 6 7 It 9 10 111 12 13 14 15! 16 17 It l»l 20 21 22 23124 25 26 27t 28 29 30 



word 1 



Relative time 



' I J 3l4 5 6 7ll 9 10 111 12 13 14 15I 14 17 II 1*120 21 22 2jl/« r. 24 27? 2fc 29 » ji 



word 12 



Seek address 



iT3 T~i 7 It 9 10 III 12 13 14 15I16 17 II I9J/0 21 22 23l24 2S 26 27(28 29 30 3 



word 2 



Year {last two digits; 
in binary) 



Julian day (in binary) 



I - J 3I4 1 6 7 It 9 If, llllj i) 14 l-,li» 17 It lot 2»j 2' 27 2;!i4 2. 7: »hh 2» 



word 3 



Screech code 



Screech 
subcode 



4 I 1 3 I 4 T~» Ml ♦ 10 III 12 13 14 isfi» 17 II 19170 2i 22 2jl/4 2: J: )?' 



CPU address 



SECONDARY RECORD FOR DISK PACK, RAD, AND 
TAPE 

This record is generated as a result of a previous device 
error and contains device status which corresponds to the 
information contained in the Device Error record (type 
X' 15') preceding this record. 



where 



screech code and screech subcode are defined in 
the CP-V/OPS Reference Manual, 90 16 75. 

recovery count is set to for initial startup as de- 

fined by startup types 1, 2, or 3 below. 
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startup type specific's the type of startup. 

1 r- Initial PO Boot 

2 - PO boot with files 

3 - System device boot (no recovery) 

4 - System recovery 

5 - Operator recovery 

6 - Secondary CPU startup 

7 - Secondary CPU shutdown 



word 12 



Generalized disk address 



T~i j il» 5 » > !i, » to nil* i] u isii* u it nljo ii » jil u u it lAm » x> 3i 



word 13 



ORG 



6 t i lU s i >U * ' iA U t la li u u 



MODE 

U l> It H i Ml ' i » ' » l l< M ' k }? ! » H bo !>i ' 



wher 



ORG is set to 1 for consecutive, 2 for keyed, and 
3 for random. 

MODE is set to 1 for IN, 2 for OUT, 4 for INOUT, 
and 8 for OUTIN. 



(For type 6 and 7, screech code fields and re- 
covery count are zero. ) 



SOFTWARE-DETECTED SYMBIONT INCONSISTENCIES 

This record is logged if the system detects files which are 
inconsistent in that the associated file pointers do not match 
or are otherwise incorrect. 



FILE INCONSISTENCY ERROR 

This record is logged if the system detects files which are 
inconsistent in that the associated file links do not match 
or are otherwise incorrect. 



word 



Type 
X'lA' 



Length 
X'OE' 



75 



Error 
subcode 



3 ! 2 3 1* T~6 Tfl » 10 III I? 13 U 15116 17 16 !«!» 21 22 23124 25 26 27 1 2S 79 30 3 



word 1 



Refative time 



i 3 JTi JT TT» 9 10 111 12 13 14 Ij!l6 17 IB l»lj0 21 22 lj\}* 25 26 ?7 ! 28 29 30 3 

words 2 through 9 



} 



File name 



fl I ? } t i '■ •> "» '. li M tl } .3 U H t )6 I? t i» l 2i }' » » ) 3< » 26 }? l }t K X K 

word: 10 and 1 



Account number 



i 2 jTji ~ rr - • '"■ •■' '2 ' > '« '•' I*. ! ' :-'/' . • .. . L« 2 J' l'h' ?' O 3 



1 


) 78 1516 2324 31 


WORD 


TYPE 
X'lB' 


LENGTH 
X«04' 





SUB- 
CODE 


.1 


RELATIVE TIME 


2 


CODE 
C'O-CF' 


BAD VALUE FOR EXPECTED 
GENERALIZED DISK ADDR. 


3 





BEST FILE STARTING POINT 
GENERALIZED DISK ADDR. 



CODE 



0- 1 


RESERVED 


2-6 


OUTSYM; SUB CODE IS DCT INDEX 




2 


BAD BLINK 




3 


BAD FLINK 




4 


BAD RCC 




5 


BAD SCDBI 




6 


NEWQ INDICATES THAT ADDRESS 
IS FOR A DOWN DEVICE; WORD 2 
MAY HAVE A VALID ADDRESS 



7-9 COOP; SUB CODE IS A STREAM NUMBER 

7 RECORD DOES NOT FIT IN DATA 
BUFFER; WORD 2 IS A VALID 
ADDRESS 

8 BAD FLINK 

9 RESERVED 
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90 31 138-2(9/78) 



LOST ENTRY INDICATOR 

This record is entered when buffering constraints moke error 
logging temporarily impossible. The newest entries are lost. 

word 



Type 
X'lE' 



Length 
X'Q2' 



Count of entries lost 



C \ } !U ! 6 Ui » 1 8 DM} H U Ijl lt 1 ? I l l H I M 51 H HHi » it 1 glH » jfl if 

word 1 



Relative time of last lost entry 

6 I .1 i l i i 6 >U fli Ill l5 li U l i l u i 7 It U l X 51 55 » l i« !i It gtH !< ii ) 



DUPLICATE ENTRIES 

.1 
This record is logged -if duplicate error log entries are 

generated, 
word 



Type 
X'lF' 



Length 
X'02' 



Number of entries identical 
to previous 



I 2 3 \t 5 4 Ml 9 10 111 12 13 M isl 16 1? IS I? 1 20 2f 2} 23U4 25 24 27 1 2» 29 30 31 

word 1 



Relative time of last duplicate 



8 i 2 3 < 4 i 6 7 It i li il l ii 15 u is l u l> It iMM 2.1 22 » l % K h 55> l M y M 31 



CON FIGURATION RECORD ; 

This record Is logged at system startup. 

word , 



X'21' 

5 1 » iU ! I 7 



;. | j».;. il . , i .f.;.fi:i;.,i ; w'.*.i l 



Length 
(variable) ,.. , , „ > A > . j 



word 1 



Relative time 



6 1 5 i l i 5 4 ? U 9 16 ti l l} H U Isll4"l7 H MH 21 55 h i 24 55 24 i> t » X 58 If 

word 2 



Model number 


•3^"" 




DCT index 


, ' ., 




2 3 14 J 4 2 11 » to 111 12 13 14 15 


14 I 1 


t It 19IJ0 Ji 22 23 


24 25 26 2r! 28 79 30 31 



word 3 



Alternate l/O address 



Primary I/O address 



I 2 jl« 3 4 7ll ♦ 10. Mi 12 13 14 1511* 17 It wl*) 21 22 23 1 24 25 26 27I2B 29 X 31 

additional words 



[ 



Words 2 and 3 may be repeated up 
to four times. The pairs of words 
will be in order by DCT index. 
Multiple records may occur. 



^ 



8 I i i\i I 6 >U i 18 tt l li » 14 » l l4 l» II \i \ H> 21 52 23 1 84 25 2* 27 l 26 29 30 3 



SYSTEM IDENTIFICATION 

This record ?s entered at system startup and recovery and is 
entered after the CONFIGURATION RECORD (type X'21'). 

word 



>e 
X'22' 



Length 
X'05' 



Core size (in 
8K word blocks) 



1 2 3l4 5 4 711 9 10 llll2 13 14 ISII6 17 II 19(20 21 22 23124 25 26 27 1 2B P » 1 



Relative time 
resolution 



POWER ON 

This record is generated as a result of the power on trap 
associated with location X'50'. 

word 



Type 
X'20' 



2<y X£ 

14 J - * 7 I > » 10 nit; 



Length 
X'02' 



CPU address 



» 2 3 U 5 4 7 I I 9 10 Ilil2 13 14 15I 1* 17 II I9lj0 21 22 23t34 25 26 27?28 29 36 31 

word 1 



Relative time 



- > 2 3I4 5 6 ?\t y 10 Illl2 13 -.4 silt 17 11 nljo 21 22 2jl 2* 25 26 27i2S 29 30 i 



word 1 



Relative time 



1 2 3 I 4 J 4 7 I t 9 10 111 12 13 14 15 1 16 17 1* 19 1 20 21 22 23 1 24 23 26 27 ' 2« 29 X II 



word 2 



System version flags (loc 2B) 

T~~\ 2 3 t 4 5 4 7ll » 10 Illl2 13 14 15l -.6 17 18 19 1 20 21 22 23 1 24 25 26 !''?8 29 30 



words 3 and 4 



Site identification (in EBCDIC) 



B i 2 i t i ' S 6 7-t l J 1 5 H <T 5 U U U l U I ? 1 1 H l X 51 53 H \ U h ii 2 ?t }i 24 f, J 



90 31 13B-2(9/78) 
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TIME STAMP 



This record is entered once each hour on the hour. 



word 



Type Length 

X'23' X'03 ' 

i TTl"! i~~ t M 8 9 10 111 I? 13 14 IJ 



T)i i ^n¥w i ^^fi u ^tui i ^Wn ' ^W v 



word 3 (if type code = 0) 



Address of routine calling ERRLOG 



S i 2 3 1 « 5 6 ?!» 9 10 III II 1} U 15I16 I? 18 l»lw }l 32 Jjlj4 IS It l?\}t'r> jfl ' 

or 



worJ 3 (if type code = 1) 



Number of graules 
bein g released 

I I 3 I 4 5 6 7 I 6 9 10 111 I) I) H 



li'iVVj 'iVlio X ti'iV-i* J5 iV iil'ii"??' 



word 1 



Relative time 



"i i 2 Tt* T~6 ; te 10 11I12 is u 13I16 17 is i»lio 11 22 23I 2* 25 2* I7J» 2* 30 



word 2 



Year (last two digits; 
in binary) 

(5 1 1 3(4 3 t, 7 I e v 10 ill n 13 14 13 



Julian day (in binary) 



16 i; It 19I20 21 21 23 1 24 25 26 27 1 28 29 JO it 



REMOTE PROCESSING ERROR 



This record is logged when an error occurs in the transmis- 
sion of data to or from a remote processing workstation. 

word 



Type 
X'26' 

i 1 JU 5 6 ; 


Length 
X'08' 

t ♦ 10 III 11 13 14 13 


1 

I/O address 

14 l> It l¥tl6 21 72 hli4 25 26 }>1« "l*"X 31 



word 1 



Relative time 

1 I 2 jl< i 6 7 It » 10 III 12 13 14 Ijl 16 17 lt"l*l» It 22 23 1 24 23 26 Z>\li ?> X 3 



word 2 



RB:FLAGS 

6 I 1 i t * 5 6"> 't t r ' to t ' l P- tJ 13 14 tillt 17 U W l iB ' li 11 » l l4 23 26 fr' l rt 29 30 31 



BAD GRANULE RELEASE 



This record is logged if the granule being released contains 
an invalid disk address or has already been released (dual 
allocation). 



word 



x^r- 



6 . ; 3't- 



Length 
X'04' 



"5 10 III 12 13 14 15 



Type code (0-bad address; 
1-duol allocation) 

16 17 It l»l» 21 22 23l24 25 26 27 1 28 29 X 31 



words 3 and 4 



Workstation name 



B ' l i i l i ! ^" > U-t ' lBMl l lf » U Isi U PII ' H t H i) » H l H » 26 » l » y x 3 T 



words 5 and 6 



Current command double word 



y i ' i i t . ; 6 >U ♦ ' i6 uhi n u itU t; u itta it » » t i« » u win » x y 
word 7 



RP1 



I 2 3 I 4 3 6 7 



RP2 



t » 10 It! 12 13 14 tj 



RP3 



14 17 It 1»Ij0 II 22 23 



RP4 



24 25 16 27 12S n X 31 



word 1 



word 2 



Relative time 



l'>2 13 u 15! 16 17 It 19I20 21 22 23l24 25 2* Z7 1 28 29 X 31 



Generated disk address 

I 2 Tt7 5 6 7 I 6 9 10 III 17 13 14 15 f Id. 17 It 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



where 

type identifies the type of error log record. 

length specifies the number of 32-bit words con- 
tained in the error log record. 

I/O address is a 16-bit address representing the 
physical I/O address. 

relative time represents milliseconds since mid- 
night. Resolution is 2 msec. 
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RB:FLAGS specifies the contents of RB:FLAG at the 
time of the error. RBrFLAG is described in the 
CP-V/Data Base Technical Manual, 90 19 95. 

workstation name specifies the workstation name 
(in TEXT format, left-justified and padded with 
blanks) if the terminal is logged on. 

current command doubleword specifies the command 
doubleword of the t/Othat was taking place when 



.he error occurred. For Xerox 7670 RBTs, the, 
current command doubieword contains the second 
command doubleword used to write the text of an 
output message and is meaningful only far RP1 ~0, 
1, A, or B. 

RP1, RP2, RP3, and RP4 have specific meaning for 
the type of remote Workstation associated with the 
record. The meanings are listed in Tables E-2 
through E-7. 



Table E-2. Xerox 7670 RBT - RP1, RP3, and RP4 \ 



RP1 Value 


Meaning 


Corresponding RP3 Meaning 


Corresponding RP4 Meaning 


1 


First character in record not SOH. 


Current character position. 


Offending character. 


2 


Incorrect parity on SEL. 


Current character position. 


Offending character. 


3 


Incorrect block protect. 


Current character position. 


Offending character. 


4 


Third character in record not STX. 


Current character position. 


Offending character. 


5 


RBBAT COMBUF or MPOOL unavailable 
for log-on. 


Meaningless. 


Meaningless. 


6 


Incorrect character parity. 


Currerit character position. 


Offending character. 


7 


Record trailer character not ETX. , <-. •■ ' 


V ... t ' 

Current character position. 


Offending character. 


8 


Incorrect block check parity. 


Current character position. 


Offending character. 


9 


Incorrect block check. 


Current character position. 


Offending character. 


A 


Communication line time-out. 


Meaningless. 


Meaningless. 


B 


NAK received. 


Response received reading for ACK. (RP3 and RP4 combine 
to be a halfword). 


C 


Garbled ACK or NAK. 


Response received reading for ACK. (RP3 and RP4 combine 
to be a halfword). 
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Table E-3. Xerox 7670 RBT - RP2 



RP2 Value 


Meaning (Current Function Code) 





Write card punch. 


1 


Write line printer. 


2 


Send ACK. 


3 


Write TOF (Block protect = 0). 


4 


Write TOF (Block protect = 1). 


5 


Write SPACE (Block protect = 0). 


6 


Write SPACE (Block protect = 1). 


7 


Read card reader. 


8 


Write TOF (log-on). 


9 


Read card reader (special). 


A 


Read ACK card punch. 


B 


Read ACK line printer. 


C 


Read ACK TOF (Block protect = 0). 


D 


Read ACK TOF (Block protect = 1). 


E 


Read ACK SPACE (Block protect = 0). 


F 


Read ACK SPACE (Block protect = I). 


10 


Write EOT. 


11 


Write DC1. 


12 


Write ACK (special). 


13 


Write NAK. 


14 


Write NAK (special). 


15 


Write BEL (on error). 



Table E~4<. IBM 2780 RBT - 


RPl and RP4 


. RPl 
Value 


Meaning 


Corresponding RP4 
Meaning 


1 


Disconnect due to . 






a. EOT on read. 


EOT 




b. Use of 2780 on 
IRBT only system. 


ENQ 


2 


Line timeout. 


Same as RP2. 


3 


ENQ not received 
on logon read. 


Character received. 


4 


No EOT after EOF sent. 


Character received. 


5 


a. ENQ in text mode. 


Character received. 




b. No ENQ answer- 
ing WACK. 


Character received. 




c. ENQ answer to 
ACK of EOF. 


Character received. 


6 


NAK received. 


Character received. 


8 


CRC failed on input. 


Last character 
CRCed. 


9 . 


Unknown response 
reading for ACK. 


Character received. 


A 


Trailer character not 
ETB or ETX. 


Character received. 


C 


Header character not 
STX. 


Character received. 



Table E-5. IBM 2780 RBT - RP2 and RP3 



Value 


RP2 (Current Function Code) 


RP3 (Calling Function Code) 





Disconnect. ,- 


Software error — should not occur. 


1 


Write data. 


Write. 


2 


Send ENQ. 


Send ENQ (Wait). 


3 


Send ACK O. 


Read. 


4 


Send WACK. 


Send WACK (Wait). 
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Table E-5. IBM 2780 RBT - RP2 ond RP3 (cont. ) 



Value 


RP2 (Current; Function Code) 


RP3 (Calling Function Code) 


"| 


5 


Write data. 




Write EOF. 




6 


Send ENQ. . 




Request to output.. 




7 


Read for ACK, ENQ, EOT (depends on 


RP3). 


POL for input. 




8 


R«ed for ENQ. 




Logon. 




9 


Read. 




Software error — should not occur. 




A 


Send NAK. 




Software error — should not occur. 




B 


Send AC K 1. 




Software error — should not occur. 




C 


Send EOT. 




Software error — should not occur. 





Table E-6. IRBT - RPl and RP4 



RPl 
Value 


Meaning 


Corresponding RP4 Meaning 


"6 


Recoverable block check error. 


Difference (mod 16) between expected 
and received BCBs. 


1 


Catastrophic block check error (NAK sent 
in case of line error). 


Difference (mod 16) between expected 
and received BCBs. . 


2 


Communication linetjme-out. 


Same as RP2. 


3 


Read for ENQ timed -out (logon). 


Same as RP2. 


4 


Received ACK O instead of SIGNQN at logon. 


ACK O 


5 


Inappropriate line bid (not ENQ-master, not 
ACK O-slave). 


Line bid received. 


6 


NAK received. 


NAK. 


7 


Read timed out. 


Same as RP2. 


8 


Incorrect CRC. 


Last character CRCed. 


9 


Trailer character not ETB. 


Offending character. 


A 


Leader character not STX. 


Offending character. 


B 


Lost data. 


First character after IDLE. 


C 


Garbled ACK O-NAK. 


First character of message. 
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.-v 


Table E-7. IRBT- RP2 and RP3 


-Value. . 


, RP2 (Current Function Code) , 


RP3. (Calling Function Code) 





Disconnect. 


v Software error — should not occur. 


1 


Write block. 


Write block - read block. 


2 


Write ACK. 


Write ACK - read block. 


3 


Write block. 


Write block (Wait-a-bit) - Read special. 


4 


Write Wait-a-bit. 


Write Wait-a-bit — Read special. 


5 


Read block. 


Software error — should not occur. 


6 


Send NAK. 


Software error — should not occur. 1 " 


7 


Send ENQ. 


Logon as Slave. 


8 


Read for ENQ. 


Logon as Master. 


9 


ACK O to ENQ. 


Logon as Master after ENQ Read. 


A 


Read logon record. 


Software error — should not occur. 


B 


NAK logon record. 


Software error — should ijot occur.' 


If errors with the same Rl 
consecutive errors, replac 


*1 code occur consecutive 1/, this code may c 
:ing another legal RP3 code. 


ippear in the RP3 field for the second and subsequent 



OPERATOR MESSAGE 

This record is interjected as the resultofan operator ERRS END 
key-in or by a diagnostic program. It isgenerallyused tode- 
scribe unusual conditions surrounding a particular error. 

word 



Type 
X'27' 



Length 
(variable) 



1 2 3 I 4 5 6 718 9 10 1 W 12 13 14 15116 17 16 19120 21 22 23T24 25 26 27128 29 30 31 



word 1 



Relative time 



word 1 



Relative rime 



I 2 3 \* S 6 7 U « 10 II 1 12 13 14 tfi 16 17 18 19I2O ?l 22 23 1 24 25 26 27 1 28 29 30 31 

word 2 f, '.'-'"' 



I/O address 



DCT index 



1 2 3 14 5 * 71 8 .9 10 II 1 12 13 14 15 16.17 18 19T20 21 22 23T24 25 26 27T28 29 30 31 

word 3 -,*- ' ■ 



I/O count 



1 2 314 5 * 7 18 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



1 2 3l4 5 6 7 Is 9 10 111 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 

additional words 



word 2 



Message from the operator in TEXTC 
format. (Maximum size is 71 characters 
plus the count byte.) 



Words 2 and 3 may be repeated up to four 
times. The pairs of words will be in order 
by DCT index. Multiple records may occur. 



1 2 3 I 4 5 6 7 t 8 9 10 111 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



1 2 3 14 5 6 718 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



I/O ACTIVITY COUNT 

This is recorded once per hour and at recovery, 
word 



Type 
X'28' 



I 2 3 14 5 6 7 



Length 



( variable) 

~ 9 10 111 12 13 14 15 



DCT index of first device 



16 17 IS l?i 20 21 22 23 1 24 25 26 27 1 28 79 30 31 



HARDWARE ERROR 

This record is logged when a hardware error has been de- 
tected, the type of error being indicated by the Trap CC. 
For Sigma 6 and 7, this record is generated as a result of 
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the memory parity interrupt associated with location X'56'. 
For Sigma 9 and Xerox 560 this record is generafedyqs.a re- 
sult of the parity error trap associated with foedtion X X 4C'. 

word ■ .''•..■..■■ ' 



Type 
X'2D' 



I 2 3 14 5 6 7 



Length 
X'OB* 



8 9 10 III 12 13 14 IS 



CPU address^ 



16 17 18 ]9l20 21 22 23! 24 25 26 27 1 28 29 30 31 



word 1 



Relative time 



I 2 3)4 5 6 7 1 8 9 10 111 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 2J 26 27 1 28 29 30 31 



words 2 and 3 



PSD word 1 
PSD word 2 



12 3 I 4 5 6 7 Is 9 10 11 1 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



words 4 and 5 



Reserved for future use 



I4 5 6 7 I 



1 24 25 26 27I2 



0' 1 2 3 14 5 6 7 18 9 10 11(12 13 J4^ 151 16 17 18 19120 21 22 23124 25 26 27(28 29 30 3l< 



word 6 



Trap CC 



I 2 314 5 6 7 



8 9 10 11112 13 14 15 



■Jv.^- ' v. ■ ■ ' ■ ' . ' . ' . ' A ' . ' . 



VfiVi TiYi Ti-iViY.W 
9120 21 22 231: 



IAP indicates, when set, that a pari ty error occurred 
due fo an indirect address fetch. Words' 9 and 10 
will be zero in this case. , • v 

RBP indicates, when set, that a parity error is present 
in the associated R -block registers. (Xerox 560 
only.) 

ANLZ CC specify the addressing type for the 
effective real address (words 9 and 10). If the 
instruction is an immediate type, these address 
fields will be zero. The ANLZ CC settings 
are: 

Bit Bit 1 Bit 2 Bit 3 









- 





Byte 








- 


1 


Immediate, byte 





1 


- 





Halfword 


1 





- 





Word 


1 





- 


1 


Immediate, word 


1 


1 


- 





Doubleword 


- 


- 





- 


Direct addressing 


_ 


'_ 


1 


- 


Indirect addressing 



16 17 18 19T20 21 22 23124 25 26 27128 29 30 31 



word 7 



^JU 



Real aacJiiess of trapped instruction 

• V" • ■ * 



1 2 3 1 4 5 6 7 Is 9 ItMll'12 13 14 15 1 16 17 IB wlzo 21 22 23^4 25 26 27 1 28 29 30 31 



word 8 



Trapped instruction 



1 2 3 I 4 5 6 7 Is » 10 11 1 12 13 14 I5I 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



word 9 



ANLZ CC 



Effective virtual address 



lll2 13 14 15 1 



1 2 314 5 6 718 9 10 II I 12 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



word 10 



Effective real address 



U 5 6 7 I 



j 2 3 14 5 6 7 18 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



I20 21 22 23l2 



where 



FIP indicates, when set, that a parity error occurred 
while fetching the instruction (causing a trap 4C) 
on a Sigma 9 or Xerox 560, or that a memory par- 
ity occurred (causing a machine interrupt using 
location 56) on a Sigma 6 or 7. 



WATCHDOG TIMER 

This record is generated as a result of the instruction watch- 
dog timer runout trap associated with location X'46 1 . 

wordO 



Type 
X'2E' 

1 2 3 U i 



1 2 3 U 5 6 7 



Length 
X'QB' 

8 9 10 111 12 13 14 15 



CPU address 



16 17 18 19l20 21 22 23l24 25 26 27I28 29 30 31 



word 1 



Relative time 



U 5 6 7 I 



1 2 314 5 6 718 9 10 11112 13 14 15T16 17 18 19(20 21 22 23(24 25 26 27(28 29 30 31 



1 24 25 26 Z7I2 



words 2 and 3 



PSD word 1 
PSD word 2 



1 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 3 



words 4 and 5 



Reserved for future use 



7~i 2 3 I 4 5 6 7 I e 9 10 111 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27J28 29 30 31 
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word 6 



Trap.CC 



1 2 3 I 4 5 6 ; I 6 9 19 111 12 13 U 1. 






)t 17 IE I»I3 21 22 23i2« 2i 26 2J\2it', 30 3 



word 7 



Real address of trapped instruction 



i 2 3 l< 5 6 7 I 8 9 10 llll2 13 U I5ll6 17 18 . 19 1 20 21 22 231.24 25 26-27128 29 30 31 

word 8 



Trapped instruction 



I 2 3 14 5 6 7 i8 r 10 111 12 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



word 9 



ANLZ CC 



Effective virtual address 



1 2 3 I 4 5 6 7 18 9 10 111 12 13 14 I5I16 17 le 191 20 21 22 23! 24 25 26 27I28 29 30 3! 

word 10 



Effective real address 



"0 - 1 2 3 I 4 5 4 7 I 3 9 10 III 12 13 14 15 1 16 17 18 19l20 21 22 23 1 24 25 26 27 1 28 29 30 31 



word 7 



Real address of trapped Instruction 



1 2 3 I 4 5 6 7 1 8 9 10 111 12 13 14 is! 16 17 18 19120 21 22 23 1 24 75 26 27123 29 30 Jf 

word 8 . 



Trapped instruction 



1 2 31 4 5 6 7 18 9 10 llTl2 13 14 15116 17 ie 19120 21 22 23124 25 26 27128 29 30 31 



word 9 



ANLZ CC 



Effective virtual address 



1 23 14 56789 10 11112 13 14 15M6 17 16 19120 21 22 23124 25 26 27128 29 30 31 



word 10 



Effective real address 



i 2 3 I 4 5 6 Til 9 10 111 12 13 14 I5I16 17 18 19I2O 21 22 23 1 24 25 26 27I28 29 30 31 

where FIP, IAP, RBP, and ANLZ CC have the same mean-? 
ings as for the hardware error record (X* 17'). 



where FIP, IAP, RBP, and ANLZ CC have the same mean- 
ing as for the hardware error record (X'17 1 ). 



INSTRUCTION EXCEPTION 

This record is logged when program executions traps to lo- 
cation X'4D' on a Sigma 9 or Xerox 560 due to an instruc- 
tion exception condition. 

word 



Type 
X'2F' 



Length 
X'QB' 



CPU address 



12 314 5 6 7T8 9 10 111 1/ 13 14 15TT6 17 18 19120 21 22 23124 25 26 2712829 30 31 



rord 1 



Relative time 



PFI PRIMARY RECORD 

This record is logged when program execution is interrupted 
to location X'56' on the Xerox 560 due to a Processor Fault 
Interrupt condition. 



word 
Type 


Length 


$x#~w 


^^.-■-.•-,,....: 1 


X'30' 

\ 2 3 \* 5 6 7 


X'02' 

8 9 10 11 i H 13 14 15 


116 17 18 191 


- J ....';.. : , ,',' i' ' i :: iNinM,iiV.., ■ ,-_J 
20 21 2? 23124 25 26 27123 29 30 31 



word 1 



Relative time 



1 2 3 I 4 5 6 7 I 8 ? 10 111 12 13 14 isll6 17 18 19 ! 20 21 22 23 1 24 25 26 27I26 29 30 31 



I 2 3 14 5 6 718 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



words 2 and 3 



PSD word 1 
PSD word 2 



~\ 2 3~t"4 ii 6 7 I 8 5 10 111 12 13 14 15 1 16 17 18 I9I2O 21 22 23 1 24 25 26 27(28 29 30 31 



words 4 and 5 



Reserved for future use 



1 2 3 I 4 5 6 7 Is 9 10 11 1 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27I 28 29 30 31 



MFI PRIMARY RECORD 

This record is logged as a result of the memory fault in- 
terrupt associated with location X'57 1 on a Sigma 9 or 
Xerox 560. 

word 



Type 

X'31' 

e 'i j st4 s * i 


Length 
X'Q2' 

8 9 10 1*1 12 13 U 15 


1 , 

CPU address 

16 17 18 l4|20 21 22 23li4 25 26 27I28 29 30 3! 



word 6 




, 










■ 






J( 










,„,_„,,,,» t 


Trap CC 




R 

B 
P 


I 
A 

P 


f 
I 

P 


'■':':■ < ■ •"•' ' ' '' .'. '■.■.'■'.: + ■■'■'■ '-" : 'v>' ; ' 


'''iiiiiiiiw. 








i'i : ' : i 


'"■'•'v>' : ' 






^'C%V'^ : viu : w 


1 2 3 U 5 6 7 


8 9 10 


11 


12 


13 


14 


15 


16* 17 


18 


1* 


20 2! 


22 


23124 


25 


26 27 


128 29 30 31 



word 1 



Relative time 

1 2 3 I 4 5 6 7 I 8 9 10 11 1 12 13 14 15 1 16 17 18 19! 20 21 22 23 1 24 25 26 27)28 29 30 31 
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XEROX 560 SECONDARY RECORD FOR POLL 
INFORMATION 

This record is logged to record specific information obtained 
by issuing a POLL instruction subsequent to detecting hard-* 
ware errors. One record is produced per valid poll status 
received. 

word 



Type 
X'32' 



Length 
X'03' 



CPU address 



1 2 3 I 4 5 4 7 I 8 9 10 111 12 13 14 IS I 16 17 18 19120 21 22 23124' 25 26 27t28 29 30 31 



word 1 



Relative time 



i 2 3U 5 6 7(8 9 10 111 12 13 U 15! 16 17 18 19I2O 21 22 23I24 25 26 27 S 28 29 30 31 



word 2 










.•.'•■;■ ■ 


Unit 
address • 


Poll 

cc 


Unit 
type 


Poll status 


1 


2 3 1 4 5 6 7 


8 9 10 11 


12 13 14 15 


16 


17 13 19120 21 22 23l24 25 26 27 1 28 29 30 31 



where unit type has the following meanings: 

1 - Basjc Processor 

2 «-"" Memory Interface 

3 - Processor Interface 

4 - Multiplexor IOP 

5 - Rotating Memory Processor 

6 - Not Used 

7 - System Control Processor 



word 3 



Memory 'Stafus' v/ord I 



1 2 3 I 4 5 6.7"! 8 v~ W ul.12 13 l« Hi 16 17'"7&~l«20 21 '22 23\ti '."ijlt 



SIGMA 9 MEMORY PARITY SECON DARY RECORD 

This record is logged as a result of the memory fault inter- 
rupt associated with location X'57' or the memory parity 
trap associated with location X'4C on the Sigma 9 or 
Xerox 560. This record follows record type X'17 1 and 
record type X'3T. 

word 



Type 
X'43' 



Length 
X'05' 



CPU address 



1 2 3 I 4 5 6 7 8 9 10 HI 12 13 14 IS 1 16 17 18 I9l20 21 22 23124 25 26 27 1 28 29 30 31 



1 20 21 22 23h 



word 1 



Relative time 



"tl 5 6 7~tl 9 10 111 12 13 14 15 1 



1 2 3 I 4 5 6 7 18 9 10 1 1 1 12 13 14 151 16 17 18 19 1 20 21 22 23124 25 26 27128 29 30 31 



I 20 21 22 23 1 4 



word 2 



Memory status word 



i 2 3 I 4 5 4 7~tl 9 10 111 12 13 14 15 1 16 17 18 J9 1 20 21 22 23 1 24 25 26 27 1 28 29 30 3 



word 3 



Memory status word 1 



1 2 3f4 5 6 7 18 9 10 111 12 13 14 15M6 17 18 19120 21 22 23124 25 26 27128 29 30 31 



word 4 



Memory status word 2 



2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 3 



wqrd 5' 



Real address 



1 2 3 1 4 5 6 7J8 9 10 llll2 13 14 15 1 16 17 IB <9 1 20 21 22 23(24 25 26 27(28 29 X 3 



XEROX 560 MEMORY PARITY SECONDARY RECORD 

This record is logged to record specific information returned 
in response to an LMS instruction subsequent to detecting 
hardware errors. 

word 



Type 
X'42' 



1 2 3T4 5 6 7 



Length 
X'04' 



8 9 10 III 12 13 14 15 



CPU address 



}\k 21 22 23! 



MEMORY PARITY SECONDARY RECORD 

This record is logged to record specific information obtained 
by scanning memory to attempt to isolate locations which 
cannot sustain correct parity. 

word 



16 17 18 19120 21 22 23124 25 26 27128 29 30 31 



Type 



X'49' 

1 2 3 L 5 6 7 



Length 
X'OB' 



9 10 111 12 13 14 15 



CPU address 



?l 20 21 22 23 1 



16 17 IB 19120 21 22 23124 25 26 27128 29 30 31 



word 1 



Relative time 



1 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15l 16 17 18 J9 1 20 21 22 23I24 25 26 27 1 28 29 30 31 



word 1 



Relative time 



1 2 3 14 5 4 7T8 9 10 111 12 13 14 151 16 17 18 19120 21 22 23124 25 26 27128 29 30 3 



word 2 



Memory status word 

1 2 J t« 5 6 7 U 9 10 111 12 13 U 15l 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 26 29 30 3l' 



word 2 



Number of bad locations in memory 



1 2 3 i 4. 5 6 7U 9 10 111 12 13 14 15I 16 17 18 19 1 20 21 22 23(24 25 26 27 1 28 29 30 31 



.0 31 13B-l(!l/76) 
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ford 3 



Logical AND of addresses of the bad locations 



»l» 21 22 23 1 3 



1 2 3 14 5 6 7 16 9 10 111 12 13 14 I5ll6 17 18 19120 21 22 23124 25 26 27\ 28 29 30 31 

word 4 



Logical OR of addresses of the bad locations 

i 2 3 I 4 5 6 7 I 8 5 10 111 12 13 14 islli 17 18 19 1 20 21,22 23 1 24 25' 26 27\lS 29 30 31 



word 5 



Logical AND of contents of the bad locations 



14 5 6 7 I 



1 2 3 14 5 6 7 18 9 10 111 12 13 M 15116 17 18 19120 21 22 23 1 24 25 26 27126 29 30 31 



I 24 25 26 27 1 2 



word 6 



Logical OR of contents of the bad locations 



1 2 3U 5 6 7 I 8 9 10 111 12 13 14 151 16 17 18 19120 21 22 23124 25 26 27128 29 30 31 



I 16 17 18 19I2 



word 7 



LMS 
CC 



Address of lowest location with bad parity 



I 234567 18 9 10 H I 12 13 14 15ll6 17 18 19120 21 22 23 1 24 25 26 27128 29 30 31 



word 8 



Contents of lowest location with bad parity 



0123 [4 567189 10 11112 13 14 15(16 17 18 19120 21 22 23124 25 26 27128 29 30 31 

word 9 



LMS 
CC 



Address of highest location with bad parity 



ll 12 13 14 ul 



1 2 3 4 5 6 7 1 8 9 10 11 1 12 13 14 15l 16 17 18.19120 21 22 23 1 24 25 26 271 26 29 30 31 



word 10 



Contents of highest location with bad parity 

Z I 5 3T4 5 6 7+8 9 10 11112 13 14 15l!6 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 3 



ENQUEUE TABLE OVERFLOW 

This record is logged when an Enqueue CAL has been re- 
jected because there are insufficient unused entries in the 
Enqueue tables. 

word 



Type 
X'50' 



Length 
X'03' 



0" 1 2 3 F4 5 6 7 8 9 10 111 12 13 14 15 1 16 17 18 l?l 20 21 22 23I 24 25 26 27l28 29 30 31 

word 1 



Relative time 



"S I J TT4 5~" 6 TTi 9 10 111 12 13 14 15! 16 17 18 19 ! 20 21 22 23 1 24 25 26 27 1 28 29 30 31 

word 2 



User ID 



U 5 6 7 I 



Entry count (in binary) 



I 20 21 22 23 1 2 



1 2 3 I 4 56 7 18 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 

Entry count is the number of entries in the enqueue table 
belonging to the specified user at the time the error log 
entry was made. 



PARTITIONED RESOURCE 

This entry is logged when a resource is partitioned via the 
SYSCO N processor by the operator. 

word 



Type 
X'51' 



Length 
X'03 1 



Model number 



1 2 3 I 4 5 6 7T8 9 10 11112 13 14 I5M6 17 18 19120 21 22 23 1 24 25 26 27 1 2o 29 30 3 



word 1 



Relative time 



H f 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15ll6 17 18 I? 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



word 2 



1 2 37 4 5 6 7 18 9 10 1U 12 13 14 15 



I/O address 



16 17 18 19120 21 22 23124 2i 26 27128 29 30 31 



where 

F = for device entry. 
F = 1 for controller entry. 



RETURNED RESOURCE 

This entry is logged when a resource is returned from being 
partitioned via the SYSCON processor by the operator. 

word 



Type 
X'52' 



Length 
X'03'" 



Model number 



I 2 J I 4 56 7189 10 HI 12 13 14 151 16 17 18 19120 21 22 23T24 25 26 27 1 26 29 30 31 



word 1 



Relative time 

1 .2 3I4 5"~~6 7 I 8 9 10 111 12 13 14 15 1 16 17 18 I9I2X) 21 22 23 1 24 25 26 27 1 28 29 30 31 



word 2 



0- 



I 8 9 10 111 



I/O address 



123I4567I89 10 1TT 12 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



where 

F = for device entry. 
F = 1 for controller entry. 
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APPENDIX F. IEROX STANDARD OBJECT LAH6UA6E 



INTRODUCTION 

GENERAL 

The Xerox standard object language provides a means of 
expressing the output of any Xerox processor in standard 
format. All programs and subprograms in this object format 
can be loaded by the Monitor's relocating loader. Such a 
loader is capable of providing the program linkages needed 
to form an executable program in core storage. The object 
language is designed to be both computer- independent and 
medium-independent; i.e., it is applicable to any Xerox 
computer having a 32— bit word length, and the same format 
is used for both cards and paper tape. 



SOURCE CODE TRANSLATION 

Before a program can be executed by the computer, it must 
be translated from symbolic form to binary data words and 
machine instructions. The primary stages of source program 
translation are accomplished by a processor. However, under 
certain circumstances, the processor may not be able to trans- 
late the entire source program djjrectly into machine language 
form; 

If a source program contains symbolic forward references, a 
single-pass processor such as the.Xerox Symbol assembler can 
not resolve such references intpmdchine language. This is be- 
cause the machine language value for the referenced symbol 
is not established by a one-pass processor until after the state- 
ment containing the forward reference has been processed. 

A two-pass processor, sucfv:as the Xerox Meta-Symbo! assem- 
bler, is capable of making '"retroactive" changes in the 
object program before the objecft code is output. Therefore, 
a two-pass processor does not have to output any special 
object codes for forward references. An example of a for- 
ward reference in a Symbol source program is given below. 



EQU $ + 3 

CI, 5 Z 

LI, R Z 

EQU 2 

BG Z 

EQU Z + 1 



In this example the operand $ + 3 is not a forward reference 
because the assembler can evaluate it when processing the 
source statement in which it appears. However, the oper- 
and Z in the statement 

CI,5 Z 

is a forward reference because it appears before Z has been 
defined. In processing the statement, the assembler outputs 
the machine-language code for CI, 5, assigns a forward ref- 
erence number (e.g., 12) to the symbol Z, and outputs that 
forward reference number. The forward reference number 
and the symbol Z are also retained in the assembler's symbol 
table. 

When the assembler processes the source statement 

LI,R Z 

it outputs the machine-language code for LI, assigns a for- 
ward reference number (e.g., 18) to the symbol R, outputs 
that number, and again outputs forward reference number 
12 for symbol Z. 

On processing the source. statement 

Z EQU 2 

the assembler again outputs symbol Z's forward reference 
number and also outputs the value, which defines symbol Z, 
so that the relocating l,6ader will be able to satisfy refer- 
ences to Z in statements CI, 5 Z and LI, R Z. At this time, 
symbol Z's forward reference number (i.e., 12) may be 
deleted from the assembler's symbol table and the defined 
value of Z equated with the symbol Z (in the symbol table). 
Then./, .subsequent references to Z, as in source statement 



BG 



would not constitute forward references, since the assembler 
could resolve them immediately by consulting its symbol 
table. 

If a program contains symbolic references to externally 
defined symbols in one or more separately processed subpro- 
grams or library routines, the processor will be unable to 
generate the necessary program linkages. 

An example of an external reference in a Symbol source pro- 
gram is shown below. 



REF 



ALPH 



LI, 3 ALPH 



Although a discussion of the object language is not directly 
pertinent to CP-V, it is included in this manual because it 
applies to some of the processors operating under CP-V. 



When the assembler processes the source statement 
REF ALPH 
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it outputs the symbol ALPH, In symbolic' (EBCDIC) form, in 
a declaration, specifying that the symbol is an externa! ref- 
erence. At this time, the assembler also assigns a declara- 
tion name number to the symbol ALPH but does not output 
the number. The symbol and name number are retained in 
the assembler's symbol table. 

After a symbol has been declared an external reference, it 
may appear any number of times in the symbolic subprogram 
in which it was declared. Thus, the use of the symbol 
ALPH in the source statement 

LI, 3 ALPH 

in the above example, is valid even though ALPH is not 
defined in the subprogram in which it is referenced. 

The relocating loader is able to generate interprogram link- 
ages for any symbol that is declared an external definition 
in the subprogram in which that symbol is defined. Shown 
below is an example of an external definition in a Symbol 
source program. 



DEF 



ALPH 



for their representation, depending on the type end specific 
content of each item. A group of 108 bytes, or fewer, com- 
prises a logical record. A load item may be continued from 
one logical record to the next. 

The ordered set of logical records that a processor generates 
for a program or subprogram is termed an "object module". 
The end of an object module is indicated by a module-end 
type code followed by the error severity level assigned to 
the module by the processor. 

RECORD CONTROL INFORMATION 

Each record of an object module consists of 4 bytes of con- 
trol information followed by a maximum of 104 bytes of load 
information. That is, each record, with the possible excep- 
tion of the end record, normally consists of 108 bytes of 
information (i.e., 72 card columns). 

The four bytes of control information for each record have 
the form and sequence shown below. 

Byte 



LI, 3 ALPH 



Record Type 



Mode 



1 



Format 







ALPH AI,4 X'F2' 

When the assembler processes the source statement 

DEF ALPH 

it outputs the symbol ALPH, in f symbolic (EBCDIQ form, in 
a declaration specifying Vhat the symbol is an external defi- 
nition. At this time, the assembler also assigns a declaration 
name number to the symbol ALPH but does not output the 
number. The symbol and name number pre retained in the 
assembler's symbol table.- 

After a symbol has been declared an external definition it 
may be used (in the subprogram in which it was declared) in 
the same way as any other symbol. Thus, if ALPH is used as 
a forward reference, as in the source statement 



LI, 3 



ALPH 



above, the assembler assigns a forward reference number to 
ALPH, in addition to the declaration name number assigned 
previously. (A symbol may be both a forward reference and 
on external definition.) 

On processing the source statement 

ALPH Al,4 X'F2' 

the assembler outputs the declaration name number of the 
label ALPH (and an expression for its value) and also outputs 
the machine-language code for AI, 4 and the constant X'F2'. 

OBJECT LANGUAGE FORMAT 

An object language program generated by a processor is out- 
put as a string of bytes representing "load items". A load 
item consists of an item type code followed by the specific 
load information pertaining to that item. (The detailed format 
of each type of load item is given later in this appendix.) 
The individual load items require varying numbers of bytes 



Byte 1 






Sequence Number 





Byte 2 




7 


Checksum 





Byte 3 



Record Size 



7 

Record Type specifies whether this record is the last 
record of the module: 

000 means last 

001 means not last 

Mode specifies that the loader is to read binary infor- 

mation. This code is always 11. 

Format specifies object language format. This code is 

always 100. 

Sequence Number is for the first record of the module 
and is incremented by 1 for each record thereafter, 
until it recycles to after reaching 255. 

Checksum is the computed sum of the bytes comprising 

the record. Carries out of the most significant bit 
position of the sum are ignored. 

Record Size is the number of bytes (including the record 

control bytes) comprising the logical record (5 < record 
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size < 108). The recordsize will normally be 108 bytes 
for all records except the last one, which maybe fewer. 
Any excess bytes in a physical record are ignored. 

LOAD ITEMS 

Each load item begins with a control byte that indicates the 
item type. In some instances, certain parameters are also 
provided in the load item control byte. In the following dis- 
cussion, load items are categorized according to their function: 

1. Declarations identify to the loader the external and 
control section labels that are to be defined in the 
object module being loaded. 

2. Definitions define the value of forward references, 
external definitions, the origin of the subprogram being 
loaded, and the starting address (e.g., as provided in 

a Symbol/Meta-Symbol END directive). 

3. Expre ssion evaluation load items within a definition 
provide the values (such as constants, forward refer- 
ences, etc.) that are to be combined to form the final 
value of the definition. 

4. Loading items cause specified information to be stored 
into cpre memory. 

5. Miscellaneous items comprise padding bytes and the 
module-end indicator. 

DECLARATIONS 

In order for the loader to provide the linkage between subpro- 
grams, the processor must generate for each external refer- 
ence or definition a load item, referred to as a "declaration", 
containing the EBCDIC code representation of the symbol 
and the information that the symbol is either an external ref- 
erence or a definition (thus, the loader will have access to 
the actual symbolic name). 

Forward references are always internal references within an 
object module. (External references are*never considered 
forward references.) The processor does not generate a dec- 
laration for a forward reference as it does for externals; how- 
ever, it does assign name numbers to the symbols referenced. 



Declaration name numbers (for control sections and external 
labels) and forward reference name numbers apply only within 
the object module in which they are assigned. They have no 
significance in establishing interprogram linkages, since 
external references and definitions are correlated by match- 
ing symbolic names. Hence, name numbers used in any 
expressions in a given object module always refer to symbols 
that have been declared within that module. 



The processor must generate a declaration for each symbol 
that identifies a program section. Each object module pro- 
duced by an assembler is considered to consist of at least 
one control section. If no section is explicitly identified 
in the source program, the assembler assumes it to be a 
standard control section (discussed below). The standard 
control section is always assigned a declaration name 



number of 0. A!! other control sections (i.e., produced by 
a processor capable of declaring other control sections) ore 
assigned declaration name numbers (1, 2, 3, etc.) in the 
order of their appearance in the source program. 

In the load items discussed below, the access code', pp, des- 
ignates the memory protection class that is to be associated 
with the control section. The meahing'of this code is given 
below.. 



PP 


Memory Protection Feature' 


00 


Read, write, or access instructions from. 


01 


Read or access instructions from. 


10 


Read only. 


11 


No access. 



Control sections are always allocated on a doubleword 
boundary. The size specification designates the number of 
bytes to be allocated for the section. 

Declare Standard Control Section 



Byte 



Control byte 











1 





1 


1 



Byte 1 



Access code 




Size (bits 1 through 4) 


P P. 


,0 




Byte 2 



Size (bits 5 through 12) 




Byte 3 



Size (bits 13 through 20) 



This item declares the standard control section for the object 
module. There may be no more than one standard control 
section in each object module. The origin of the standard 
control section is effectively defined when the first reference 
to the standard control section occurs, although the declara- 
tion item might not occur until much later in the object 
module. 



"Read" means a program can obtain information from the 
protected area; "write" means a program can store informa- 
tion into a protected area; and, "access" means the compu- 
ter can execute instructions stored in the protected area. 
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This capability is required by one-pass processors, since. 
the size of a section cannot be determined until oil 'of 
the load info*rnatron for that section has been generated by 
the processor-. .. • " ■ 

Declare Nonstandard Control Section 
Byte 



Control byte 















1 



1 

Byte 1 



Access code 




Size (bits 1 through 4) 


P P 









Byte 2 



Size (bits 5 through 12) 




Byte 3 



Size (bits 13 through 20) 



This item declares a control section other than standard con- 
trol section (see above). 



Declare Page Boundary Control Section 
Byte 









Control Byte 











1 


1110 



Byte 1 


1 


2 


3 


4 5 6 7 


Access 


code 




Size (bits 1 through 4) 


P 


P 











Byte 2 


1 


2 


3 


4 5 6 7 






Size 


(bits 5 


through 12) 





Byte 3 








7 






Size 


(bits K 


J through 20) 





7 

This item declares a nonstandard control section beginning 
on a memory page boundary. 



Declare Dummy Section 
Byte p\ • v. ■;■'.: ' / 



« 


"" '•*':. 


* Control k,y\e 




b* V 


o 


1 


1 


■.pX**-\ ! 

Byte 1 


1 


2 3 4 5 


6 7 


First byte of name number 





Byte 2 






7 


Second byte of name number 





Byte 3 






7 


Access 


code 




Size (bits 1 


through 4) .. .' 


P 


P 








Byte 4 








Size, (bits 5 through 12) 







Byte 5 




7 




Size (bits 13 through 20) 






«:. 





7 

This item comprises a declaration for a dummy control sec- 
tion. It results in the allocation of the specified dummy 
section, if that section has not been allocated previously 
by another object module. The label that is to be associ- 
ated with the first location of the allocated section must be 
a previously declared external definition name. (Even 
though the source program may not be required to explicitly 
designate the label as an external definition, the processor 
must generate an external definition name declaration for 
that label prior to generating this load item.) 

Declare Root Dummy Section 



Byte 










Control byte 








10 





1 



Byte 1 


1 


2 3 4 5 


6 


7 


First byte of name number 





If the module has fewer than 256 previously assigned name 
numbers, this byte is absent. 
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Byte 2 






Second byte of name number 






Byte 3 



Access code 




Size (bits 1 through 4) 


P P 








4 • 



Byte 4 






Size (bits 5 through 12) 




9 
Byte 5 




7 


,' 


Size (bits 13 through 20) 




}r- _ 



This item comprises a dedpration for a dummy control sec- 
tion that is to reside in the ROOT segment. It results in the 
allocation of the specif ied. dummy section in the ROOT seg- 
ment, if that section hos nof-been allocated previously by • 
another object module „ The label that is to be associated 
with the first location of the allocated section must be a 
previously declared external definition name. (Even 



though the source program may not be required to explicitly 
designate the label as an external definition, the processor 
must generate an external definition name/ declaration for 
that label prior to generating this lodd item.) 



Declare External Definition Name 



Byte 



Control byte 














1 


1 



Byte 1 


1 


2 


3 4 5 


6 


7 






Name 


length, in bytes (K) 










Byte 2 



First byte of name 




Byte K+l 



Last byte of name 
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This item declares a label (in EBCDIC code) that is an exter- 
nal definition within the current object module. The name 
may not exceed 63 bytes in length. 

Declare Primary External Reference Name 
Byte 



Control byte 











1 





1 



Byte 1 


1 


2 3 4 


5 


6 


7 






Name length (K), in 


bytes 










Byte 2 



First byte of name 



Byte K+l 


* 


M Last byte of name 





This item declares a symbol (in EBCDfC code) that is a pri- 
mary external reference within the current object module. 
The name may not exceed 63 bytes in length. • 

A primary external reference is capable of causing the loader 
to search the system library for a corresponding external 
definition. If a corresponding external -definition is not 
found in another load module of the program or in the system 
library, a load error message is output and the fob is errored. 

Declare Secondary External Reference Name 



Byte 




















Control byte 




















1 


:»'■■ 






Byte 1 








Name length, 


in bytes (K) 





Byte 2 



First byte of name 



Byte K+l 




Last.byte of name. , * , , . 





7 ■ 

This item declares a symbol (in EBCDIC code) that is a sec- 
ondary external reference within the current object module. 
The name may not exceed 63 bytes in length. 

A secondary external reference is not capable of causing the 
loader to search the system library for a corresponding exter- 
nal definition. If a corresponding external definition is not 
found in another load module of the program, the job is not 
errored and no error or abnormal message is output. 

Secondary external references often appear in library routines 
that contain optional or alternative subroutines, some of which 
may not be required by the user's program. By the use of pri- 
mary external references in the user's program, the user can 
specify that only those subroutines that are actually required by 
the current job are to be loaded. Although secondary external 
references do nor cause loading from the library, theydo cause 
linkages to be made between routines that are loaded. 



DEFINITIONS 

When a source language symbol is to be defined (i.e. ^.equa- 
ted with a value), the processor provides for such a value by 
generating an object language, expression to be evaluated by 
the loader* Expressions are of variable length, and terminate 
with an expression-end control byte (see "Expression Evalua- 
tion!' in this appendix). An expression is evaluated by the ad- 
dition or subtraction of values specified by the expression. 

Since the loader must derive values for the origin and start- 
ing address of a program, these also require definition. 

Origin 

Byte 



Control byte 







12 3 4 5 6} 

This item sets the loader's load-location counter to the 
value designated by the expression immediately following 
the origin control byte. This expression must not contain 
any elements that cannot be evaluated by the loader (see 
"Expression Evaluation" which follows). 

Forward Reference Definition 



Byte 












Control byte 








1 
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Byte 1 




*. First byte of reference number , 






Byte 2 



Second byte of reference number 



7 

This item defines the value (expression) for a forward refer- 
ence. The referenced expression is the one immediately 
following byte 2 of this load item, and must not contain 
any elements that cannot be evaluated by the loader (see 
"Expression Evaluation" which follows). 



Forward Reference Definition and Hold 



Byte 










Control byte 








10 









Byte 1 


1 


2 3 4 5 


6 


7 


First byte of reference number 





Byte 2 




1 ■ 




7 






Second byte of reference number 






' ' * ■• ' " 







This item defines the value (expression) for a forward refer- 
ence and notifies the loader that this value is to be retained 
in the loader's symbol table until the module end is encoun- 
tered. The referenced expression is the, one immediately 
following the name number. It may contain values that have 
not been defined previously, but all such vg lues must be 
available to the loader prior to the module end'. 

After generating this load item, the processor need hot retain 
the value for the forward reference, since that responsibility 
is then assumed by the loader. However, the processor must 
retain the symbolic name and forward reference number 
assigned to the forward reference (until module end). 



Byte 2 




Second byte of name number 


* ' 



This item defines the iJ&ai-we (expression) for an external 
definition name. The name number refers to a previously 
declared definition name. The referenced expression is 
the one immediately following the name number. 



Define Start 



Byte 












Control byte 











) 1 





1 







This item defines the starting address (expression) to be- used 
at the completion of loading. The referenced expression is 
the one immediately following the control byte. 



EXPRESSIOIJIVALUATIGN 

A processor must generate aft ob-ject language expression 
whenever it needs to coflpffiufiicate to the loader one of 
the following: 

1. A program load origin. 

2. A program staffing address, . 

3. An external definition value. 

4. A forward reference value. 

5. • A field definition value. 



Such expressions may include sums and differences of con- 
stants, addresses, and external or forward reference values 
that, when defined, will themselves be constants or addresses. 



External Definition 



Byte 



Control byte 











1 





1 






1 

Byte 1 



First byte of name number 



After initiation of the expression mode, by the use of a con- 
trol byte designating one of the five items described above, 
the value of an expression is expressed as follows: 

1. An address value is represented by an offset from the 
control section base plus the value of the control sec- 
tion base. 



If the module has fewer than 256 previously assigned name 
numbers, this byte is absent. 
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2. The value of a constant is added to the accumulated 
sum by generating an Add Constant (see below) control 
byte followed by the value, right- justified in four 
bytes. 

The offset from the control section base is given as a 
constant representing the number of units of displace- 
ment from the control section base, at the resolution 
of the address of the item. That is, a word address 
would have its constant portion expressed as a count 
of the number of words offset from the base, while the 
constant portion of a byte address would be expressed 
as the number of bytes offset from the base. 

The control section base value is accumulated by means 
of an Add Value of Declaration (see below)or Subtract 
Value of Declaration load item specifying the desired 
resolution and the declaration number of the control 
section base. The loader adjusts the base value to the 
specified -address resolution before adding it to the cur- 
rent partial sum for the expression. 

In the case of an absolute address, an Add Absolute 
Section ^tee below) or Subtract Absolute Section con- 
trol byte must be included in the expression to identify 
the value as an address and lb specify its resolution. 



3. An external definition of forward reference value is 
included in an expression by means of a load item add- 
ing or subtracting the appropriate declaration or for- 
ward reference value. If the value is an address, 
the resolution specified,, tn the contra! byte is used to 
align the value before adding it to the-currenfrjp0rtial 
sum for the expression. If the value is, a consrojrff, no 
alignment is necessary. 



Change Expression. Resolution control byte occurs, then 
the expression resolution is unaffecfe*tf. 



Note that the "expression for a program load origin or 
starting address must resolve to a simple address, and the 
single nonzero resolution counter must have a final count 
of +1 when such expressions are evaluated. 



In converting a byte address to a word address, the two least 
significant bits of the address are truncated. Thus, if the 
resulting word address is later changed back to byte resolu- 
tion, the referenced byte location will then be the first byte 
(byte 0) of the word. 



After an expression has been evaluated, its final value is 
associated with the appropriate load item. 



In the following diagrams of load item formats, RR refers to 
the address resolution code. The meaning of this code is 
given in the table below. 



RR 


Address Resolution 


00 
01 
10' 
*1 


Byte 

Halfword 
Word 
Doubleword 



Expressions are not evaluated by the loader until all re- 
quired values are available. In evaluating an expression, 
the loader maintains a count of the number of values added 
or subtracted at each of the four possible resolutions. A 
separate counter is used for each resolution, and each 
counter is incremented or decremented by 1 whenever a 
value of the corresponding resolution is added to or sub- 
tracted from the loader's expression accumulator. The final 
accumulated sum is a constant, rather than an address 
value, if the final count in all four counters is equal to 0. 
If the final count in one (and only one) of the four counters 
is equal to +1 or -1, the accumulated sum is a "simple ad- 
ress" having the resolution of the nonzero counter. If 
more than one of the four counters hava a nonzero final 
count, the accumulated sum is termed a "mixed-resolution 
expression" and is treated as a constant rather than an 
address. 



The Iqad J tepff discussed in this appendix, "Expression 
Evaluatioft*y may appear only in expressions. 

Add Constant 



Byte 














Control byte 


















1 



Byte 1 


1 


2 3 4 5 


6 


7 


First byte of constant 





The resolution of a simple address may be altered by 
means of a Change Expression Resolution (see below) 
control byte. However, if the current partial sum is 
either a constant or a mixed-resolution value when the 



Byte 2 




Second byte of constant 
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Byte 3 



"Third byte 6f constant 




Byte 4 



Fourth byte of constant 



This item causes the specified four-byte constant to be added 
to the loader's expression accumulator. Negative constants 
are represented in two's complement form. 

Add Absolute Section 



Byte 














Control byte 








1 


1 


1 


R 


R 







1 



This item identifies the associated value (expression) as a 
positive absolute address. The address resolution code, RR, 
designates the desired resolution. 

Subtract Absolute Section . 



Byte 






''" . r 








Control byte 








1 


1 - 1 





R 


R 







1 



This item identifies the associated value (expression) as q 
negative absolute address. The address resolution code, 
RR, designates the desired resolution. 

Add Value of Declaration 



Byte 












Control byte 





1 








R 


R 



Byte 1 




First byte of name number 






Byte 2 



Second byte of name number 



If the module has fewer than 256 previously assigned name 
numbers, this byte is absent. 



This, it;em causes the value of the specified declaration to be 
added tq the loader's expression accumulator. The address 
resolution code, RR, designates the desired resolution, and 
the name number refers to a previously declared definition 
name that is to be associated with the first location of the 
allocated section. 

One such item must appear in each expression for a reloca- 
table address occurring within a control section, adding the 
value of the specified control section declaration (i.e., 
adding the byte address of the first location of the control 
section). 

Add Value of Forward Reference 



Byte 


• 












Control byte 








1 


1 




R 


R 



Byte 1 


1 


2 


3 4 5 




6 


7 




First 


byte 


of forward reference number 










Byte 2 



Second byte of forward reference number 



„ 7 

This item causes the value of the specified forward reference 
to be added to the loader's expression accumulator. The 
address resolution code, RR, designates the desired resolu- 
tion, and the designated forward reference must not have 
been defined previously. 



Subtract Value of Declaration 



Byte 










Control byte 








10 10 


R 


R 



Byte 1 


1 


2 3 4.5 


6 


7 


First byte of name number 





Byte 2 








7 


Second byte of name number' 





This item causes the value of the specified declaration to 
be subtracted from the loader's expression accumulator. 
The address resolution code, RR, designates the desired 
resolution, and the name number refers to a previously de- 
clared definition name that is to be associated with the 
first location 'of the allocated section. 
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Subtract Value of Forward Reference 



Byte 






Control byte 





1 1 ]' R 


R 



Byte 1 


1 2 3 4 5 6 


7 


First byte of forward reference number 





Byte 2 




7 


Second byte of forward reference number 





This item causes the value of the specified forward reference 
to be subtracted from the loader's expression accumulator. 
The address resolution code, RR, designates the desired reso- 
lution, and the designated forward reference must not have 
been defined previously. 

Change Expression Resolution 



Byte 


"" 










Control byte 




a..,. 


1 


J o . 





R 


R 



1- 2 J 3 4 5 6 7 

This item causes the address resolution in the expression to 
be changed to that designated by RR. 

Expression End 

Byte 



Control byte 

















1 






1 



4 



This item identifies the end of an expression (the value of 
which is contained in the loader's expression accumulator). 





Symbol Types 


Type 


Meaning, of 5-Bit- Code 


00000 


Instruction 


00001 


Integer 


00010 


Short, floating-point 


00011 


long floating-point 


00100- , 


Complex (short floating-point) 


00101 


Double complex (long floating-point) 


00110 


Hexadecimal (and packed decimal) 


00111 


EBCDIC 


01000 


First instruction in ROM 


01001 


Integer array 


01010 


Short floating-point array 


01011 


Long floating-complex array 


01100 


Complex array 


01101 


Double complex array 


OHIO 


Hexadecimal array 


01111 


EBCDIC array 


10000 


Undefined symbol 


10001 


Logical 


10010 i 




through J 


(Currently unused) 


11000 ' 




11001 


Logical array 


11010 1 




through } 


(Currently unused) 


inn ) 





Internal Resolution 



IR 


Address Resolution 


000 


Byte 


001 


.Halfword 


010 


Word 


01 1 


Doubleword . 


100 


• Constant 



Type Information for External Symbol 



Byte 














Control byte 











1 








1 



FORMATION OF INTERNAL SYMBOL TABLES 

The three obfect code control bytes described below are re- 
quired to supply the information necessary in the formation 
of Internal Symbol Tables. 

In the following diagrams of load item formats, Type refers 
to the symbol types supplied by the object language and 
maintained in the symbol table. IR refers to the internal 
resolution code. Type and resolution are meaningful only 
when the value of a symbol is an address. In this case, it 
is highly likely that the processor knows the type of value 
that is in the associated memory location, and the type field 
identifies it. The resolution field indicates the resolution 
of the location counter at the time the symbol was defined. 
The following tables summarize the combinations of value 
and meaning. 



Byte 1 








Type field 


IR field 






Byte 2 



Name number 



Byte 3 (if required) 



Name number (continued) 



90 31 13B-l(ll/76) 



Appendix F 205 



This item provides type information for external symbols. 
The Type and IR fields are defined above. The name 
number, field consists of one or two bytes (depending on the 
current declaration count) which ipecifies the declaration 
number of the external definition- 
Type and EBCDIC for Internal Symbol, 



Byte 










Control byte 








1 










Byte 1 



Type field 



IR field 




Byte 2 



Length of name (EBCDIC characters) 





Byte 3 






7 






First byte of name in EBCDIC 







Byte n 






7 


Last byte of name in EBCDIC 





Byte n 


+ 1, 


. - . 


7 




Expr 


ession defining value of internal symbol 







7 

This item supplies type and EBCDIC.foran internal symbol . The 
load items for Type and IR are as abos'e . Length of name speci - 
fiesthe length of the EBCDIC name in characters. The name, in 
EBCDIC, is specified in the required number of bytes, followed 
by the expression defining the internal symbol. 

EBCDIC for an Undefined Symbol 



Byte 












Control byte 








1 





1 


1 




Byte 1 



Length of name (EBCDIC characters) 




Byte 2 



First byte of name in EBCDIC 




Byte n 



Last byte of name in EBCDIC 



Byte n -» 1, n + 2 




Two bytes of symbol 


associated forward reference number 





7 

This item is used to associate a symbol with a forward reference. 
The length of name and name in EBCD IC are the same as in the 
above ifem." The last two bytes specify the forward reference 
number with which the above symbol is to be associated. 



LOADING 



Load Absolute 



Byte 








Control byte 


1 


N N 


N 


N 


1 

Byte 1 


23 4 5 


6 


7 


First byte to be loaded 





Byte NNNN 




■* *v 


Last byte to be loaded 





v • .. 7 

This item causes the next NNNN bytes to be loaded abso- 
lutely (NNNN is expressed in ©dtural binary fpfm, except 
that 0000 is interpreted as 16 rather than 0). Tneioad loca- 
tion counter is advanced appropriately. 

Load Relocatable (Long Form) 



Byte 














Control byte 





1 





1 Q 


C 


R 


R 



Byte 1 



First byte of name number 




Byte 2 



Second byte of name number 



7 

This item causes a four-byte word (immediately following this 
load item) to be loaded, and relocates the address field 
according to the address resolution code, RR. Control bit 
C designates whether relocation is to be relative to a for- 
ward reference (C = 1) or relative to a declaration (C =0). 
Control bit G designates whether a 1 -byte (Q = 1) or a 
2-byte (Q = 0) name number follows the control byte of 
this load item. 

If the module has fewer than 256 previously assigned name 
numbers, this byte is absent. 
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If relocation is to be relative to a forward reference, the 
forward reference must not have been defined previously. 
When this load item is encountered by the loader* the load 
location counter can be aligned with a word boundary by 
loading the appropriate number of bytes containing all 
zeros (e.g., by means of a load absolute item). 



Load Relocatable (Short Form ) 



Byte 1 



Byte 






-- 








Control byte 


1 


c 


D 


D D 


D 


D 


D 



12 3 4 5 6 7 

This item causes a four-byte word (immediately following 
this load item) to be loaded, and relocates the address field 
(word resolution). Control bitC designates whether reloca- 
tion is to be relative to a forward reference (C= 1) or rela- 
tive to a declaration (C = 0). The binary number DDDDDD 
Ts/fhe forward reference number or declaration number by 
which relocation is to be accomplished. 



If relocation is to be relative to a forward reference, the 
forward reference must notjfave been defined previously. 
When this,4^W. item is! encountered by the loader, the load 
location counter must fee on a word boundary (see "Load " 
Relocatable (Lang Form]", above). 



Repeat Load 



Byte 










Control byte 








11 


1 


1 



Byte 1 


1 


2 3 45 


6 


7 


First byte of repeat count 





Byte 2 








7 


Second byte of repeat count 





This item causes the loader to repeat (i.e., perform) the 
subsequent load item a specified number of times. The 
repeat count must be greater than 0, and the load item to 
be repeated must follow the repeat load item immediately. 

Define Field 



Byte 












Control byte 











1 


1 


1 



■■ 


Field location constant, in bits (K) 


■ 


■ ''■*■ ■ . 



Byte 2 




7 


Field length, in bits (L) 





This item defines a value (expression) to be added to a field 
in previously loaded information. The field is of length L 
(Is Ls 255) and terminates in bit position T, where: 

T = current load bit position -256 +K. 



The field location constant, K, may have any value from 
1 to 255. The expression to be added to the specified 
field is the one immediately following byte 2 of this load 
item; 



MISCELLANEOUS LOAD ITEMS 



Padding 



Byte 












Control byte 





















Padding bytes are ignored by the loader. The object lan- 
guage allows padding as a convenience for processors. 

Module End 

Byte 









Control byte 

















1 


1 


1 






Byte 1 


1 


2 


3 4 


5 


6 


7 


Severity level 











E 


E 


E 


E 



1 



This item identifies the end of the object module. The 
value EEEE is the error severity level assigned to the 
module by the processor. 



OBJECT MODULE EXAMPLE 

The following example shows the correspondence between 
the statements of a Meta-Symbol source program and the 
string of object bytes output for that program by the assem- 
bler. The program, listed below, has no significance other 
than illustrating typical object code sequences. 
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Example 
















1 










DEF 


AA,B3,CC 


CC IS UNDEFINED BUT CAUSES NO 
ERROR 


2 










REF 


R2,RTN 


EXTERNAL REFERENCES DECLARED 


3 


ooooo 






ALPHA 


CSECT 




DEFINE CONTROL SECTION ALPHA 


4 


000C8 








ORG 


200 


DEFINE ORGIN 


5 


OO0C8 


22000000 


N 


AA 


LI,CNT 





DEFINES EXTERNAL AA; CNT IS A 
FWD REF 


6 


000C9 


32000000 


N 




LW,R 


RZ 


'r IS A FORWARD REFERENCE; 


7 








* 




■< 


RZ IS AN EXTERNAL REFERENCE, AS 


8 








* 






.DECLARED IN LINE 2 


9 


000CA 


50000000 


N 


RPT 


AH,R 


KON 


DEFINES RPT; R AND KON ARE 


10 








* 






FORWARD REFERENCES 


11 


000CB 


69200000 


F 




BCS,2 


BB 


' BB IS AN EXTERNAL DEFINITION/, 


12 








* 






USED AS A FORWARD REFERENCf i' : \ 


13 


OOOCC 


20000001 


N 




AI,CNT 


1 


CNT IS A FOfcWAftb REFERENCE 


14 


OOOCD 


68OO0OCA 






B 


RPT 


RPT IS A BACKWARD REFERENCE 


15 


OOOCE 


68000000 


X 




B 


RTN 


RTN IS AN EXTERNAL REFERENCE 


\f>* 


OOOCF 


0001 


A 


KON 


DATA, 2 


1 


DEFINES KON 


17 




00000003 




R 


EQU 


3 


DEFINES R 


18 




00000004 




CNT 


EQU 


4 


DEFINES CNT 


19 


OOODO 


224FFFFF 


A 


BB 


LI,CNT 


-1 


" DEFINES EXTERNAL BB THAT HAS 


20 








* 




< 


. 4 ALSO BEEN USED AS A FORWARD 


21 








* 






_ REFERENCE 


22 


000C8 








END 


AA 


END OF PROGRAM 



CONTROL BYTES (In Binary) 
Begin Record Record number: 



00111100 1 
00000000 
01100011 
01101100 



Record type: not last, Mode binary, Format: object language. 
Sequence number 
Checksum: 99 
Record size: 108 



Record control 
► information not 
part of load item 



0302C1C1 (hexadecimal code comprising the load item) ^ 

00000011 Declare external definition name (2 bytes) Name: AA Declaration number: 1 



0302C2C2 
00000011 Declare externa! definition name (2 bytes) Name: BB Declaration number: 2 

0302C3C3 
00000011 Declare external definition name (2 bytes) Name: CC Declaration number: 3 j 



► Source Line 1 



0502D9E9 
00000101 Declare primary reference name (2 bytes) Name RZ Declaration number: 4 



0503D9E3D5 
00000101 Declare primary reference name (3 bytes) Name: RTN Declaration number: 5 



► Source Line 2 
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Begin Record Record number: 



0A0 10 100000320200002 
00001010 "J Define external definition 

Number 1 
00000001 , Add constant: 800 X'320' 
00100000 Add value of declaration (byte resolution) 

Number 
00000010 J Expression end 

040100000320200002 
00000100 1 Origin 
00000001 Add constant: 800 X'320' 

00100000 * Add value of declaration (byte resolution) 

Number 
00000010 J Expression end 

4422000000 
01000100 Load absolute the following 4 bytes: X'22000000' 

07EB0426000002 
000001 1^1 Def(ne field 

Field I otation constant: 235 bits 

Field length: 4 bits 

Add the following expression to the above field: 
001001 10 ' Add value of forward reference (word resolution) 

Number 
00000010 J Expression end' 

4432000000 
10000100 load relocatable (short form). Relocate address field (word resolution) 

Relative to declaration number 4 
The following 4 bytes: X'32000000' 

07EB0426000602 
00000111 Define field 

Field location constant: 235 bits 

Field length: 4 bits 

Add the following expression to the above field: 
00100110 Add value of forward reference (word resolution) 

Number 6 
00000010 Expression end 

CC50000000 
11001100 Load relocatable (short form). Relocate address field (word resolution) 

Relative to forward reference number 12 
The following 4 bytes: X'SOOOOOOO' 

07EB0426000602 
00000111 Define field 

Field location constant: 235 bits 

Field length: 4 bits 

Add the following expression to the above field: 
00100110 Add value of forward reference (word resolution) 

Number 6 
00000010 Expression end 



Source Line 5 



Source Line 4 



* Source Line 5 



► Source Line 6 



► Source Line 9 



No object code is generated for source lines 3 (define control section) or 4 (define origin) at the time they are encountered. 
The control section is declared at the end of the program after Symbol has determined the number of bytes the program requires. 
The origin definition is generated prior to the first instruction. 
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Begin Record Record, number: 



D 269290000 
11010010 Load relocatable (short form). Relocate address field (word resolution) 

Relative to forward reference number, 18 
The following 4 bytes: X'69200000" 

4420000001 
01000100 Load absolute the following 4 bytes: X' 20000001' 

07EB0426000002 
00000111 Define field 

Field location constant: 235 bits 
f . Field length: 4 bits 

Add the following expression to the above field: 
00100110 Add value of forward reference (word resolution) 

Number 
00000010 Expression end 

80680000CA 
10000000 Load relocatable (short form). Relocate address field (word resolution) 

Relative to declaration number 
The following 4 bytes: X'680000CA' 

8568000000 
10000101 Load relocatable (short form). Relocate address field (word resolution) 

Relative to declaration number 5 
The following 4 bytes: X^SOOOOOO' 

08 
00001000 Define forward reference (continued in record 1) 



Source Line 1 1 



Source Line 13 



Source Line 14 



Source -Line \5 



Source Line 16 



Begin Record Record number:! 



00011100 
00000001 
11101100 
01010001 



Record type: last, Mode: binary, Format: object language. 
Sequence number 1 
Checksum: 236 
Record size: 81 



Record Control 
Information 



000C010000033C 200002 (continued from record 0) 

Number 12 
00000001 Add constant: 828 X'33C 

00100000 Add value of declaration (byte resolution) 

Number 
00000010 Expression end 

42001 
01000010 Load absolute the following 2 bytes: X'0001' 

080006010000000302 
00001000 Define forward reference 

Number 6 
00000001 Add constant: 3 X'3' 

00000010 Expression end 

080000010000000402 
00001000 Define forward reference 

Number 
00000001 Add constant: 4 X'4' 

00000010 Expression end 



Source Line 16 



Source Line 17 



Source Line 18 
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Begin Record Record number: 1 



OF00024100 
00001 111 Repeat load 

Repeat count: 2 
01000001 Load absolute the following 1 bytes: X'00' 

0800120100000340200002 
00001000 Define forward reference 

Number 18 
00000001 Add' constant: 832 X^O' 

Add value of declaration (byte resolution) 

Number 
00000010 Expression end 

OA020 1 00000340200002 

00001010 Define external definition 
Number 2 

00000001 Add constant: 832 X'340' 

001,00000 Add value of declaration (byte resolution) 

Number 
00000010 Expression end 

44224FFFFF 
01000100 Load absolute the following 4 bytes: X'224FFFFF' 

0D0 100000320200002 
00001101 t)efine start 

00000001 Add constant: 800 X'320 J 

00100000 • Add value of decl&reffjon (byte resolution) 

Number 
00000010 Expression end ' 

OB000344 

00001011 Declare standard control section declaration number:, 
Access code: Full access. Size 836 X*344' 



Advance to Word 
Boundary 



Source Line 19 



Source Line 22 



0E00 
00001110 Module end 

Severity level: X'0' 



A table summarizing control byte codes for object language" Ipad items is given below. 



Object Code 


Control Byte 






Type of Load Item 














Padding 











1 


Add constant 








1 





Expression end 








1 


1 


Declare external definition name 





1 








Origin 





1 





1 


Declare primary reference name 





1 


1 





Declare secondary reference name 





1 


1 


1 


Define field 





1 








Define forward reference 





1 





1 


Declare dummy section 





1 


1 





Define external definition 1 
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Ob 


ect Code 


Con 


trol 


Byte 






- , , ' -...—.. 

Type of Load. Hem 





,0 










1 


1 


Declare standard ^cgflitrol section 













1 








Declare nonstandard control section 








o ! 




1 





1 ; • 


. Define start 













1 


1 


' 


Module end 













1 


1 


1 


Repeat load 








1 











. 


Define forward reference and hold 








1 











1 


Provide type information for external symbol 








1 








1 





Provide type and EBCDIC for internal symbol 








1 








1 


1 


EBCDIC and forward reference number for undefined symbol 








1 


1 








1 


Declare ROOT dummy section 








1 


1 


1 


1 





Declare page boundary control section 





1 











R 


R 


Add value of declaration 





1 








1 


R 


R 


Add value of forward reference 





1 





1 





R 


R 


Subtract value of declaration 





1 





1 


1 


R 


R 


Subtract value of forward reference 





1 


1 








R 


R 


Change expression resolution 





1 


1 





1 


R 


R 


Add absolute section 





1 


1 


1 





R 


R 


Subtract absolute section 





) -..o 





N 


N 


N 


N 


Load absolute 





1 


1 


Q 


C 


R 


X 


Load relocatable (long form) 


1 


C D 





D 


D 


D 


b 


Load relocatable (short form) 
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90 31 13B-l(ll/76) 



APPENDIX 8. XEROX STANDARD COiPRESSEO LAHOUi 



The Xerox standard compressed language is used to represent 
source EBCDIC information in a highly compressed form. 

Meta-Symbol (along with several of the utility programs) 
accepts this form as input or output, will accept updates to 
the compressed input and will regenerate source when re- 
quested. No information is destroyed in the compression or 
decompression. 

Records may not exceed 108 bytes in length. Compressed 
records are punched in the binary mode when represented 
on card media. Therefore, on cards, columns 73 through 
80 are not used and are available for comment or identifi- 
cation information. 

The first four bytes of each record are for checking purposes. 
They are as follows: 

Byte 1 Identification (00L1 1 000) L = 1 for each record 
except the last record, in which case L=0. 



Byte 2 Sequence number (0 to 255 and recycles). 

Byte 3 Checksum which is the least significant 8 bits 
of the sum of all bytes in the record except 
the checksum byte itself. Carries out of the 
most significant bit are ignored. If the 
checksum byte is all Vs, do not checksum 
the record. 

Byte 4 Number of bytes comprising record including 
the checking bytes (s 108) 

The rest of the record consists of a string of 6-bit and 8-bit 
items. Any partial item at the end of a record is ignored. 

The following six-bit items (decimal number assigned) com- 
prise the string control: 



Item 


Function 


Item 


Function 


. 


Ignore 


32 


O 


1 


Not currently assigned 


33 


P 


2 


End of line 


34 


Q 


3 


End of file 


35 


R 


4 


. Use 8-bit character that follows 


36 


S 


5 


Use n+ 1 blanks (next 6-bit item is n) 


37 


T 


6 


Use n+ 65 blanks (next 6-bit item is n) 


38 


U 


7 


Blank 


39 


V 


8 





40 


W 


9 


1 


41 


X 


10 


2 


42 


Y 


11 


3 


43 


Z ■ 


12 


4 


44 


. 


13 


5 


45 


< 


14 


6 


46 


( 


15 


7 


47 


+ 


16 


8 


48 


1 


17 


9 


49 


& 


18 


A 


50 


$ 


19 


B 


51 


* 


20 


C 


52 


) 


21 


D 


53 


* 


22 


E 


54 


—i 


23 


F 


55 


- 


24 


G 


56 


/ 


25 


H 


57 


> 


26 


I 


58 


% 


27 


J 


59 


i— i 


28 


K 


60 


> 


29 


L 


61 


: 


30 


M 


62 


• 


31 


N 


63 


= 


Eight-bit c 


laracters are in uncompressed EBCDIC format (e 


.g., !@ # ?). 
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APPENDIX H. XEROX STANDARD SYMBOLS, COOES AND CORRESPONDENCES 



XEROX STAHDARD SYMBOLS AND COOES 

The symbols listed here include two types: graphic symbols 
and control characters. Graphic symbols <ste displayable 
and printable; control characters are not. Hybrids are SP 
(the symbol for a blank space), and DEL (the delete code) 
which is not considered a control command. 



Two types of code are also shown: (l)the 8-bit Xerox Stan- 
dard Computer Code, i.e., the Xerox Extended Binary- 
Coded- Interchange Code (EBCDIC); and (2) the 7-bit Amer- 
ican National Standard Code for information Interchange 
(ANSCII), i.e., the Xerox Standard Communication Code. 



XEROX STANDARD CHARACTER SETS 

1. EBCDIC 

57-character set: uppercase letters, numerals, space, 
and &-/.<>() + I $ * :; , 
% ' @ ' = 

63-character set: same as above plus / I ? 



2. ANSCII 

64-character set: uppercase letters, numerals, space, 
and !"$%&'()*+ , - • / \ 
;:=<>? @ _ [] xn # | -i 

95-character set: same as above plus lowercase letters 
and|};~* 



CONTROL CODES 

In addition to the standard character sets listed above, the 
Xerox symbol repertoire includes 37 control codes and the 
hybrid code DEL (hybrid code SP is considered part of a\\ 
character sets). These are listed in the table titled CP-V 
Symbol -Code Correspondences. 



SPECIAL CODE PROPERTIES 

The following two properties of all Xerox standard codes 
will be retained for future standard code extensions: . 

K AIJ control codes, and only the control codes, have 
. their two high-order bits equal to "00*. DEL is not 
considered a control code. 



89-character set: same as 63-character set plus lower- 
case letters 



2. No twa graphic EBCDIC codes have* their seven low- 
order bits equal. 
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Table H-l . CP-V 8-Bit Computer Codes (EBCDIC) 









Most Significant Digits 












Hex 


adecimal 





1 


2 


3 


4 


5 


6 


7 


1 
8 


? 


A 


B 


C 


D 


E 


F 




Binary 


0000 


0001 


0010 


0011 


0100 


0101 


0110 


0111 


1000 


100 1 


1010 


ion 


1100 


nor 


1110 


mi 


VI 

'at 
c 

O 

o 

<*- 

"c 
a> 

o 
« 

—1 

— 





0000 


NUL 


DLE 


LF 
only 


ESC 
F 


SP 


& 


- 


A 










SP 




- 





1 


0001 


SOH 


XON 


FS 


CAN 


? 


- 


/ 


*♦ 


a 


i 




\' 


A 


j 




i 


2 


0010 


STX 


DC2 


GS 


ESC 
X 


i 




r 


-. 


b 


k 


s 


r 


B 


K 


S 


2 


3 


0011 


ETX 


X-OFF 


RS 


ESC 
P 




a 






c 


1 


t 


i' 


C 


L 


T 


3 


4 


0100 


EOT 


DC4 


US 


ESC 
U 


t 






: 


5 


d 


m 


u 


t' 


D 


M 


U 


4 


5 


0101 


HT 


LF 

NL 


EM 


ESC 
( 


€ 


T 






e 


n 


V 


]■ 


E 


N 


V 


5 


6 


0110 


ACK 


8 
SYN 


/ 


ESC 
) 




o 


bJ 


> 


f 


o 


w 




F 


O 


W 


6 


7 


0111 


BEL 


ETB 


A 


ESC 
T 






3 




g 


P 


X 




G 


P 


X 


7 


8 


1000 


EOM 
BS 


CAN 


= 


ESC 
S 


A 








h 


q 


y 




H 


Q 


Y 


8 


9 


100 K, 


ENQ 


EM 


CR 
only 


ESC 
E 


I 






V 


i 


r 


z 




I 


R 


Z 


9 


A 


1010, 


NAK 


SUB 


EOT 


ESC 
C 


2 

i 


! 


~' 


: 










1y-; J -' 






X 


B 


ion 


VT 


ESC 


BS 


ESC 
LF 


, 


■i $ 


i 


# 










■il;fv^:-: 


• 


,V':\ 


■▼■'. 


C , 


tioi 


FF' 


FS 


) 


X-ON 


i < ■ 


* 


% 


@ 








t 8 






. • .■ 


— i. 


D 


1101 


CR 


GS 


HT 


*OFF 


( 


) 




1 








]•• 


■i ,",' , 






— , 


E 


\Hq 


SO 


RS 


LF 
only. 


ESC 
R 


+ 


f ' 


> 










LostS 
Data 






■ "-;]■-, ': : : : .;* 


' 


F 


1111 


SI 


US 


SUB 


ESC 
CR 


i 2 


2 


? 


ii 






8 I 


-.• 


-j........ 


:£:-:^B-:-- 


l'--to : '^ : | 


DEL 



T 



4,7 



Notes: 



1 



The characters ^ \ { } [] are ANSCII characters that do not appear in any of the Xerox EBCDIC-based 
character sets, though they are shown in the EBCDIC table. 

The characters / I — i appear in the Xerox 63- and 89-character EBCDIC sets but not in either of the Xerox 
ANSCII-based sets. However, Xerox software translates the characters 4 I - 1 into ANSCII characters as 
follows: 

EBCDIC = ANSCII 

j. s (6-0) 

• ! 



' (7-12) 



(7-14) 

3 The EBCDIC control codes in columns and 1 and their binary representation are exactly the same as those 
in the ANSCII table, except for two interchanges: LF/NL with NAK, and HT with ENQ. 

4 Characters enclosed in heavy lines are included only in the Xerox standard 63- and 89-character EBCDIC sets. 

5 These characters are included only in the Xerox standard 89-character EBCDIC set. 

6 The EBCDIC codes in column 3 are used by COC to perform special functions. The EBCDIC codes in 
column 2 and positions AF and BC through BF are used by COC for output only. 

7 APL characters are assigned EBCDIC values that fall within the shaded area of the CP-V code set. These 
assignments are for APL internal use and are only reflected in 2741 -APL translation tables. 

8 Placing a SYN code as the last position of a nontransparent message will prevent the transmission of the SYN 
and the normal message appendage of the CR/LF pair. This allows a user to continue writing more than one 
message on the same line without affecting the carrier position. The EBCDIC SYN code is translated to an 
idle (IL) on output to 2741 terminals. 
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Table H-2. CP-V 7-Bit CommunicaH on Codes (ANSCII) 



Notes: 









Most Significant Digits 




Deci 
(rowi 

I' 
t 


mal 

,) (cof*s.)~ 


o 


1 


2 


3 


4 


5 


6 


7 




Binary 


xCOO 


xOOl 


xOlO 


xOll 


xlOO 


xlOl 


xllO 


xlll 


"5> 
h 

c 
o 
o 

*c 
.5* 
in 

o 

t> 





0000 


NUL 


DLE 


SP 





@ 


P 


\ 


P 


1 


0001 


SOH 


DC1 


s 

! 


1 


A 


Q 


a 


q 


2 


0010 


STX 


DC2 


» 


2 


B 


R 


b 


r 


3 


0011 


ETX 


DC3 


# 


3 


C 


S 


c 


s 


4 


0100 


EOT 


DC4 


$ 


4 


D 


T 


d 


t 


5 


0101 


ENQ 


NAK 


% 


5 


E 


U 


e 


u 


6 


0110 


ACK 


SYN 


& 


6 


F 


V 


f 


V 


7 


0111 


BEL 


ETB 


i 


7 


G 


W 


9 


w 


8 


1000 


BS 


CAN 


( 


8 


H 


X 


h 


x 


9 


1001 


HT 


EM 


) 


9 


1 


Y 


i 


y 


10 


1010 


LF 
NL 


SUB 


* 


: 


J 


Z 


i 


z 


11 


1011 


VT 


ESC 


+ 


i 


K 


V 


k 


{. 


12 


1100 


FF 


FS 


/ 


< 


L 


\ 


i 


1 
1 


13 


1101 


CR 


GS 


- 


= 


M 


V 


m 


I 4 


14 


1101 


SO 


RS 


. 


> 


N 


4^ S 


* n 


4 


15 


mi 


SI 


US 


/ 


? 


O 


4 


o 


DEL 



1 Most significant bit, added for 8-bit format, is either or an even-parity bit for the remaining 7 bits. 

2 Columns 0-1 are control codes. 

3 Columns 2-5 correspond to the Xerox 64-character ANSCII set. 
Columns 2-7 correspond to the Xerox 95-character ANSCII set. 

4 On many current teletypes, the symbol 

~ is t (5-14) 
_ is*- (5-15) 

- is ESC or ALTMODE control (7-14) 
} is ESC or ALTMODE control (7-13) 

and none of the symbols appearing in columns 6-7 are provided. Except for the four symbol differences 
noted above, therefore, such teletypes provide all the characters in the Xerox 64-character ANSCII set. 
(The Xerox 7015 Remote Keyboard Printer provides the 64-character ANSCII set also, but prints ^ as A. 
It also interprets the [ ] characters as I — i.) 

5 On the Xerox 7670 Remote Batch Terminal, the symbol 
! is I (2-1) ] is ! (5-13) 



[ is/ (5-11) 



'"MS 



(5-14) 



and none of the symbols appearing in columns 6-7 are provided. Except for the four symbol differences noted 
above, therefore, this terminal provides all the characters in the Xerox 64-character ANSCII set. 
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Table H-3» CP-V Symbol-Code Correspondences ' 



EBCDIC* 


Symbol 


Card Code 


ANSClI tt 


Meaning 


Remarks 


Hex. 


Dec. 


00 


* 


NUL 


12-0-9-8-1 


0-0 


null 


00 through IF are control codes. 


01 


1 


SOH 


12-9-1 


0-1 


start of header v 


On-2741. terminals, SOH is PRE. 


02 


2 


STX 


12-9-2 


0-2 


start of text 


On 2741 terminals, STX Is BY. 


03 


3 


ETX 


12-9-3 


0-3 


end of text 


On 2741 terminals, ETX is RES. 


04 


4 


EOT 


12-9-4 


0-4 


end of transmission 




05 


5 


HT 


12-9-5 


0-9 


horizontal tab 


00, 06, 07, 09-OB, and 0E-0F 


06 


6 


ACK 


12-9-6 


0-6 


acknowledge (positive) 


are idles for 2741 terminals. 


07 


7 


BEL 


12-9-7 


0-7 


bell 




08 


8 


BSorEOM 


12-9-8 


0-8 


backspace or end of message 


EOM is used only on Xerox Keyboard/ 


09 


9 


ENQ 


12-9-8-1 


0-5 


enquiry 


Printers Models 7012, 7020, 8091, 


0A 


10 


NAK 


12-9-8-2 


1-5 


negative acknowledge 


and 8092. 


0B 


11 


VT 


12-9-8-3 


0-11 


vertical tab 




OC 


12 


FF 


12-9-8-4 


0-12 


form feed 




OD 


13 


CR 


12-9-8-5 


0-13 


carriage return 


CR outputs CR and LF. 


OE 


14 


SO 


12-9-8-6 


0-14 


shift out 




OF 


15 


SI 


12-9-8-7 


0-15 


shift in 




TO 


16 


DLE 


12-11-9-8-1 


1-0 


data link escape 




11 


17 


DC1 


11-9-1 


1-1 


device control 1 


On Teletype terminals, DC! is X-ON. 


12 


18 


DC2 


11-9-2 


1-2 


device control 2 


On 2741 terminals, DC2 is PN. 


13 


19 t 


DC3 


11-9-3 


1-3 


device control 3 


DC3 is RS on 2741s and X-OFF on 


14 


20' 


DC4 


11-9-4 


1-4 


device control 4 


Teletypes. 


15 


21 


LFor NL 


11-9-5 


0-10 


line feed or new line 


On 2741 terminals, DC4 is PF. 


16 


22 


SYN 


11-9-6 


1-6 


sync 


LF outputs CR and LF. 


17 


23 


ETB 


11-9-7 


1-7 


end of transmission block 


On 2741 terminals, ETB is EOB. 


18* 


24 


CAN 


11-9-8 


1-8 


cancel 




19 * 


h 


EM 


11-9-8-1 


1-9 


end of medium 




1A 


26 


SUB 


11-9-8-2 


1-10 


substitute 


Replaces characters with parity error. 


IB 


**:*• 


ESC 


11-9-8-3 


1-11 


escape 




1C 


28** » 


FS 


11-9-8-4 


1-12 


file separator 


• 


ID 


29 


GS 


11-9-8-5 


1-13 


group separator 


10, 11, 16 t , 18, 19, and IB-IE are 


IE 


30 


RS 


11-9-8-6 


1-14 


record separator 


idles for 2741 terminals. '- ' *■ 


IF 


31/"" 


US 


11-9-8-7 


1-15 


unit separator 


■ « :-. 


20 


32 


LF only 


11-0-9-6-1 : , 


1-5 


line feed only 


20 through 2F are used by COC for 


21 


33 


FS 


0-9-1 


1-12 




output on|y. These codes are 


22 


34 


GS 


0-9-2 


1-13 




duplicates of the label entries 


23 


35 


RS 


0-9-3 


1-14 




that caused activation. The 


24 


36 


US 


0-9-4 


1-15 




20-2F entries output a single code 


25 


37 


EM 


0-9-5 , 


1-9 


«■ 


only and are not affected by any 


26 


38 


/ 


0-9-6 


2-15 




special COC functional processing. 


27 


39 


t 


0-9-7 


5-14 






28 


40 


= 


0-9-8 


3-13 






29 


41 


CR only 


0-9-8-1 


0-13 


carriage return only 




2A 


42 


EOT 


0-9-8-2 


0-4 






2B 


43 


BS 


0-9-8-3 


0-8 






2C 


44 


) 


0-9-8-4 


2-9 






2D 


45 


HT 


0-9-8-5 


0-9 


tab code only 




2E 


46 


LF only 


0-9-8-6 


1-5 


line feed only 




2F 


47 


SUB 


0-9-8-7 


1-10 






30 


48 


ESCF 


12-11-0-9-8-1 




end of file 


30 through 3F cause COC to perform 


31 


49 


CANCEL 


9-1 




delete all input and output 


special functions. 


32 


50 


ESCX 


9-2 




delete input line 




33 


51 


ESCP 


9-3 




toggle half-duplex paper tape made 




34 


52 


ESCU 


9-4 




toggle restrict upper case 




35 


53 


ESC{ 


9-5 




upper case shift 




36 


54 


ESC) 


9-6 




lower case shift 




37 


55 


ESCT 


9-7 




toggle tab simulation mode 




38 


56 


ESCS 


9-8 




toggle space insertion mode 




39 


57 


ESC E 


9-8-1 




toggle echo mode 




3A 


58 


ESCC 


9-8-2 




toggle tab relative mode 




3B 


59 


ESC LF 


9-8-3 




line continuation 


3B toggles the backspace edit mode 


3C 


60 


X-ON 


9-8-4 




start paper tape 


for 2741 terminals. 


3D 


61 


X-OFF 


9-8-5 




Stop paper tape 




3E 


62 


ESCR 


9-8-6 




retype 




3F 


63 


ESCCR 


9-8-7 




line continuation 




f Hex 


odecima 


and decimal 


notation. 








Vc 


mal noh 


3fion (column- 


row). 
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Table H-3. GP-V Symbol-Code Correspqndences (cont.) 



EBCDIC* 


Symbol 


Card Code 


ANSCH ff 


Meaning 


Remarks 


Hex. 


Dec. 


40 


64 


SR ' 


blank 


2-0 


blank 


K 


41 


65 




12-0-9-1 






41, 43, 46, and 47 are unassigned. 


42 


66 


1 


12-0-9-2 




decode 




43 


67 




12-0-9-3 








44 


68 


L 


12-0-9-4 




minimum 


42, 44, 45, 48, and 49 are APL 


45 


69 


e 


12-0-9-5 




epsi Ion 


characters for 2741 APL use only. 


46 


70 




12-0-9-6 








47 


71 




12r0-9-7 








48 


72 


A 


12-0-9-8 




delta 




49 


73 


i 


12-8-1 




index 




4A 


74 


f£ or ' 


12-8-2 


6-0 


cent or accent grave 


Accent grave used for left single 


4B 


75 


. 


12-8-3 


2-14 


period 


quote. On Model 7670, ' not 


4C 


76 


< 


12-8-4 


3-12 


less than 


available, and /= ANSCII 5-11. 


4D 


77 


( 


12-8-5 


2-8 


left parenthesis 


On 2741 APL, / is c (subset). 


4E 


78 


+ 


12-8-6 


2-11 


plus 




4F 


79 


1 or i 


12-8-7 


7-12 


vertical bar or broken bar 


On Model 7670, | not available, 
and i=ANSCH2-l. 


50 


80 


& 


12 


2-6 


ampersand 


On 2741 APL, & is fl (intersection). 


51 


81 




12-11-9-1 






51, 52, 54, 57, 58, and 59 are 


52 


82 




12-11-9-2 






unassigned. 


53 


83 


D 


12-11-9-3 




quad 


53, 55, and 56 are APL characters 


54 


84 




12-11-9-4 






for 2741 APL use only. 


55 


85 


T 


12-11-9-5 




encode 


_ « * 


56 


86 


O 


12-11-9-6 




circular 




57 


87 




12-11-9-7 








58 


88 




12-11-9-8 






v ,, 


59 


89 




11-8-1 






1 * ; ,' •■' 


5A 


90 


I 


11-8-2 


2-1 


exclamation point 


On Model 7670, I is 1 . On 274,1 . 


5B 


91 


$ 


11-8-3 


2-4 


dollars 


APL, J js? (degree). On 274l ', 


5C 


92 


* 


11-8-4 


2-10 


asterisk 


APL, $ is U (union). "■ * 


5D 


93 


) 


11-8-5 


2-9 


right parenthesis 


' - \ 


5E 


94 


} 


11t8-6 


3-11 


semicolon 


* ." 


5F 


95 


.~or— i 


11-8-7 


7-14 


tilde or logical not 


On Model 7670, ~ is not available, 
and-i- ANSCH 5-14. 


60 


96 


_ 


11 


2-13 


minus, dash, hyphen 


, «T; 


61 


97 


/ 


0-1 


2-15 


slash 


62, 64, $6/ '-and 67 are APL characters 


62 


98 


r 


11-0-9-2 




maximum 


63 


99 




11-0-9-3 






for 274}', APL use only. 


64 


100 


i 


11-0-9-4 




down arrow 


*' 


65 


101 




11-0-9-5 








66 


102 


ttl 


11-0-9-6 




omega ;* t . 


63, 65, 68, and 69 are unassigned. 


67 


103 


3 


11-0-9-7 




superset t - ' 




68 


104 




11-0-9-8 4 








69 


105 




0-8-1 








6A 


106 


As 


12-11 


5-14 


circumflex 


On Model 7670 ~ Is— i. On Model 


6B 


107 


t 


0-8-3 


2-12 


comma 


7015 ~ is A (caret). On 2741 APL, 


6C 


108 


% 


0-8-4 


2-5 


percent 


^is t . On 2741 APL, % is P. 


6D 


109 


- 


0-8-5 


5-15 


underline 


Underline is sometimes called "break 


6E 


110 


> 


0-8-6 


3-14 


greater than 


character"; may be printed along 


6F 


111 


? 


0-8-7 


3-15 


question mark 


bottom of character line. 


70 


112 


A 


12-11-0 




APL 


70-72, 74, 76, and 79 are APL 


71 


113 


. . 


12-11-0-9-1 




APL quote mark 


characters for 2741 APL use only. 


72 


114 


— 


12-11-0-9-2 




overscore 




73 


115 




12-11-0-9-3 








74 


116 


< 


12-11-0-9-4 




less than or equal 


73, 75, 77, and 78 are unassigned. 


75 


117 




12-11-0-9-5 








76 


118 


> 


12-11-0-9-6 




greater than or equal 




77 


119 




12-11-0-9-7 








78 


120 




12-11-0-9-8 








79 


121 


V 


8-1 




down delta 




7A 


122 




8-2 


3-10 


colon 




7B 


123 


f 


8-3 


2-3 


number 




7C 


124 


@ 


8-4 


4-0 


at 




7D 


125 


i 


8-5 


2-7 


apostrophe (right single quote) 


. 


7E 


126 


= 


8-6 


3-13 


equals 




7F 


127 


M 


8-7 


2-2 


quotation mark 




f Hex 


adecima 


and decima 


notation. 








Dec 


imal not 


ation (columr 


-row). 
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Table H-3. CP-V Symbol-Code Correspondences (corif.) 



EBCDIC* 






Card Code 


ANSC!I n 


Meaning '■ > . 


Remarks 


Hex. 


Dec. 


Symbol 


80 


129» 




12-0-8-1 






.80 is unasiigned. 


8! 


129 


a 


12-0-1 


6-1 




81-89, 91-99, A2-A9 comprise the 


82 


130 


b 


12-0-2 


6-2 




' lowercase alphabet. Available 


83 


131 


c 


12-0-3 


6-3 




only in Xerox standard 89- and 95- 


84 


132 


d 


12-0-4 


6-4 




character sets. 


85 


133 


e 


12-0-5 


6-5 






86 


134 


f 


12-0-6 


6-6 






87 


135 


9 


12-0-7 


6-7 






88 


136 


h 


12-0-8 


6-8 






89 


137 


i 


12-0-9 


6-9 






8A 


138 




12-0-8-2 






8A through 90 are unassigned. 


8B 


139 




12-0-8-3 








8C 


140 




12-0-8-4 








8D 


141 




12-0-8-5 








8E 


142 




12-0-8-6 








8F 


143 




12-0-8-7 








90 


144 




12-11-8-1 








91 


145 


i 


12-11-1 


6-10 






92 


146 


k 


12-11-2 


6-11 






93 


147 


1 


12-11-3 


6-12 






94 


148 


m 


12-11-4 


6-13 






95 


149 


n 


12-11-5 


6-14 






96 •" 


150 


o 


12-11-6 


6-15 






97 


151 


P 


12-11-7 


7-0 






98 


152 


q 


12-11-8 


7-1 






.99 


153 


,r 


12-11-9 


7-2 






• 9*& , 


154 


** 


12-11-8-2 






9A through Al are unassigned. - 


455 




12-11-8-3 








*9G 


156 




12-11-8-4 








9D>? 


\57 


i 
| 


12-11-8-5 








9E 


'158 


! 


12-11-8-6 








9F 


159 


I 


12-11-8-7 








A0 


160 




11-0-8-1 








Al 


161 




11-0-1 








A2 


162 


s 


11-0-2 


7-3 






A3 


163 


t ;'cW 


11-0-3 


7-4 






A4 


164 




?.1 1-0-4 


7-5 






A5 


165 


V 


11-0-5 


7-6 






A6 


166 


w - . * 


41-0-6 


7-7 






A7 


167 


X 


-11-0-7 


7-8 






A8 


168 


y 


11-0-8 


7-9 






A9 


169 


z 


11^0-9 


;7r-10 






AA 


170 




11-0-8-2 






, AA through AE are unassigned. 


AB 


171 




11 -0-8^3 






{' -L->" 4 


AC 


172 




11-0-8-4 


'■ 




■*• ^ 


AD 


173 




11-0-8-5 








AE 


174 




11 -0-8-6 








AF 


175 


1 


11-0-8-7 




logical and 


AF is used by COC for output of 
an ANSCH 7-12 code only. 


BO 


176 


\ 


12-11-0-8-1 








Bl 


177 


12-11-0-1 


5-12 


backslash 




B2 


178 






12-11-0-2 


7-11 


left brace 


On 2741 terminals, { is output as (. 


B3 


179 






12-11-0-3 


7-13 


right brace 


On 2741 terminals, } is output as ). 


B4 


180 






12-11-0-4 


5-11 


left bracket 


On Model 7670, [ is /. On Model 


B5 


181 






12-11-0-5 


5-13 


right bracket 


7015, [ is 1. 


B6 


182 




12-11-0-6 






On Model 7670, ] is !. On Model 


B7 


183 




12-11-0-7 






7015, ] is— i. 


B8 


184 




12-11-0-8 






B0 and B6 through BB are unassigned. 


B9 


185 




12-11-0-9 








BA 


186 




12-11-0-8-2 








BB 


187 




12-11-0-8-3 








BC 


188 


[ 


12-11-0-8-4 




left bracket 


BC, BD, and BF are used by COC for 


BD 


189 ' 


] 


12-11-0-8-5 




right bracket 


output of ANSCH 5-11, 5-13, and 


BE 


190 


lost data 


12-11-0-8-5 




lost data 


7-14, respectively. 


BF 


191 


— 1 


12-11-0-8-7 




logical not 


On 2741 Selectric and EBCD Standard 
Keyboards, [ is output as ( and ] 
is output as ). 


Hexadecimal end decimal 


nototion. 








Decimal notation (column- 


-row). 
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Table H~3 V CP~V Symbol-Code Correspondences (cont. ) 



EBCDIC* 


Symbol 


Card Code 


AN&CH*. 


.^Meaning 


Remarks 


Hex. 


Disc._ 


CO 


192 


SP '■• 


12-0' . ' .- 


2-0 - 


: blank 


Output only. 


CI 


193 


A 


12-1 


.4-1 




C1-C9, D1-D9, E2-E9 comprise the 


C2 


194 


B 


12-2 


4-2 




uppercase alphabet. 


C3 


195 


C 


12-3 


4-3 






C4 


196 


D 


12-4 


4-4 






C5 


197 


E 


12-5 


4-5 






C6 


193 


F 


12-6 


4-6 






C7 


199 


G 


12-7 


4-7 






C8 


200 


H 


12-8 


4-8 






C9 


201 


I 


12-9 


4-9 






CA 


202 




12-0-9-8-2 






CA through CF are unassigned. 


CB 


203 




12-0-9-8-3 








CC 


204 




12-0-9-8-4 








CD 


205 




12-0-9-8-5 








CE 


206 




12-0-9-8-6 








CF 


207 




12-0-9-8-7 








DO 


208 




11-0 






DO is unassigned. 


Dl 


209 


J 


11-1 


4-10 






D2 


210 


K 


11-2 


4-11 






D3 


211 


L 


11-3 


4-12 






D4 


212 


M 


11-4 


4-13 




,-f 


D5 


213 


N 


11-5 


4-14 






D6 


214 


O 


11-6 


4-15 




■\ ' :,. 


D7 


215 


P 


11-7 


5-0 






D8 


216 


Q 


11-8 


5-1 




■ 1 , •'' ' 


D9 


217 


R 


11-9 


5-2 






DA 


218 




12-11-9-8-2 






DA through DF are unassiaieA, 


DB 


219 




12-11-9-8-3 






"*\t"'' :. 


DC 


220 


j 


12-11-9-8-4- 






-' 


DD 


221 


. i 


12-11-9-8-5 








DE 


222 


i 
i 


12-11-9-8-6 








DF 


223 




12-11-9-8-7 








EO 


224 


_ 


0-8-2 


2-13 


minus 


Output enJy&f;! is unassigned. 


El 


225 




11-0-9-1 








E2 


226 


s : 


0-2 


5-3 






E3 


227 


T. ' 


0-3 


5-4 






E4 


228 





0-4 


5-5 






E5 


229 


V ' 


0-5 


5-6 






E6 


230 


W 


0-6 


5-7 






E7 


231 


X 


0-7 


5-8 






E8 


232 


Y 


0-8 ■ •: ■ . 


5-9 






E9 


233 


Z 


0-9 / 


$-1° 






EA 


234 




11-0-9-8-2 






EA through EF are unassigned. 


EB 


235 




11-0-9-8-3 








EC 


236 




11-0-9-8-4 








ED 


237 




11-0-9-8-5 








EE 


238 




11-0-9-8-6 








EF 


239 




11-0-9-8-7 








FO 


240 








3-0 






Fl 


241 


1 


1 


3-1 






F2 


242 


2 


2 


3-2 






F3 


243 


3 


3 


3-3 






F4 


244 


4 


4 


3-4 






F5 


245 


5 


5 


3-5 






F6 


246 


6 


6 


3-6 






F7 


247 


7 


7 


3-7 






F8 


248 


8 


8 


3-8 






F9 


249 


9 


9 


3-9 






FA 


250 


X 


12-11-0-9-8-2 




multiply 


FA through FF are APL characters 


FB 


251 


■r 


12-11-0-9-8-3 




divide 


for 2741 APL use only. 


FC 


252 


— 


12-11-0-9-8-4 




right arrow 




FD 


253 


— 


12-11-0-9-8-5 




left arrow 




FE 


254 




12-11-0-9-8-6 






FE is not assigned. 


FF 


255 


DEL 


12-11-0-9-8-7 




delete 


Special —neither graphic nor 
control symbol. 


Hexadecimal and decimal notation. 








Decimal notation (column-row). 
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Table H-4. 


ANSCII Control-Character Translation Table 










Input 




Output 


ANSCII 


TTY 
Key 


Echoed 


Prog. Receives 
(EBCDIC) 


Process 


EBCDIC 


Transmitted 
(ANSCII) 


NUL (00) 


pes 


None 




None 


None 


NUL. (00) 


Nothing (end of 
output message) 


SOH (01)* 


A c 


SOH 




SOH 


None 


SOH (01) 


SOH 


STX (02) f 


B c 


STX 




STX 


None 


STX (02) 


STX 


ETX (03)' 


c c 


ETX 




ETX 


None 


ETX (03) 


ETX 


EOT (04)* 


D c 


EOT 




EOT 


Input Complete. 


EOT (04) 


EOT 


ENQ (Q5) f 


E c 


ENQ 




ENQ (09) 


None 


HT (05) 


Space(s) if tab 


. i* 














simulation on, or 
HT (09) if not. 


ACK (06)* 


F C 


ACK 




ACK 


None 


ACK (06) 


ACK 


BEL (07) :■■ 
BS (08). t 


G c 


B|L 

• ■>■■' ■ 
BS ' 




BEL 
BS 


None 
None 


BEL (07) 
BS (08) 


BEL 
BS 


HT (09) 


fi'v 


Space to tab stop 
if tab simulation 
on'^.br 1 space if 
''Jiff. 


Spaces to tab stop, 
or one space, or tab 
(05)dependingon 
space insertion mode. 


None 


ENQ (09) 


ENQ (05) 


LF/NL (0A) 


NL * 


•vCftdnd.LF 




LF (15)'' 


Input Complete. 


NAK (0A) 


' NAK (15) 


VT (OB) 


K c 


VT 




VT 


None 


VT (0B) 


VT 


FF (OC) 


L C 


None 




FF 


Page Header and 
Input ..CofAplete; , 


FF (0C) 


Page Header 


CR (OD) 


CR 


CR and LF 




CR (0D) 


Input Complete. 


CR (0D) 


CR and LF (0A) 


SO (OE) 


N c 


SO 




SO 


None 


SO (0E) 


SO 


S! (OF) 


o c 


SI 




SI 


None 


SI (OF) 


SI 


DLE (10) f 


P c 


DLE- 




DLE 


None 


DLE (10) 


DLE 


DC1 (11) 


Q c 


DC1 




None 


Paper Tape On. 


DC1 (11) 


DC1 


DC2 (12) 


R c 


DC2 




DC2 


None 


DC2 (12) 


DC2 


DC3 (13) 


S c 


DC3 




None 


Paper Tape Off. 


DC3 (13) 


DC3 


DC4 (14) f 


T c 


DC4 




DC4 


None 


DC4 (14) 


DC4 


NAK (15) f 


u c 


NAK 




NAK (0A) 


None 


LF/NL (15) 


CR and LF (0A) 


These charact 
compatibility > 


ers are co 
«vith future 


nmunication control characters reserved for 
i hardware developments and is done so by 1 


use by hardware, 
he user at his own 


Any other use c 
risk 


jf them risks in- 
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Table H-4. ANSCII Control -Character Translation Table (cont.) 



ANSCII 



Input 



TTY 
Kev 



Echoed 



Prog. Receives 
(EBCDIC) 



Process 



Output 



EBCDIC 



Transmitted 
(ANSCII) 



SYN (16) 



ETB (17) 
CAN (18) 

EM (19) 

SUB (1A) 
ESC (IB) 

FS (1C) 
GS (ID) 
RS (IE) 
US (IF) 
t(7D) 

~(7E) 

DEL (7F) 



W^ 



X" 



Y° 



K cs 
ESC 
PREFIX 

.cs 



M 



cs 



N 



o v 



cs 



ALT- 
MODE 



ESC 
(7015) 



Rubout 



SYN 



ETB 

Back-arrow 
and CR/LF 



Back-arrow 
and CR/LF 

SUB 

None 



fS 
GS 

RS 
US 

} or None 

~or None 



SYN 



ETB 
None 

None 

SUB 
None 

FS 
GS 
RS 
US 
} or None 

~or None 

None 



None 



None 

Cancel input 
or output 
message. 

Monitor Escape/ 
Control to TEL 

Input Complete 

Initiate escape 
sequence mode. 



Input Complete 

Input Complete 

Input Complete 

Input Complefe 

| if model 37; as 
ESC if model 33, 
35, or 7015. 

~if model 37; as 
ESC if model 33, 
35, or 7015 

Rubout last 
character. 



SYN (16) 



ETB ()7) 
CAN (18) 

EM (19) 

SUB (1A) 
ESC (IB) 

FS (1C) 
GS (ID) 
RS (IE) 
US (IF) 
f(B3) 

-"(5F) 

DEL (FF) 



SYN (not trans- 
mitted for last 
character in 
user's buffer). 

ETB 

CAN 



EM 



(A3) 



.,* ESC 



' GS • 



RS 
US 
f(7D) 

~(7E) 

None 



All ANSCII upper and lower case alphabetics are translated on input into the 
corresponding EBCDIC graphics as shown in Tables C-l and C-2. All special 
graphics map as shown, allowing for Table C-l, Note 2, and the exceptions 
above for model 33 and 35. Lower case alphabetics map into corresponding 
EBCDIC upper case if the ESC U mode is set. Upper case alphabetics map 
into corresponding EBCDIC lower case if ESC) is set. 



Alphabetic and symbol output trans- 
lation is also as shown in Tables C-l 
and C-2; for Models 33 and 35, and 
7015 terminals, however, lowercase 
alphabetics are automatically trans- 
lated to upper case. 



These characters are communication control characters reserved for use by hardware. Any other use of them risks in- 
compatibility with future hardware developments and is done so by the user at his own risk. 



222 Appendix W 



Table H— 4. Substitutions for Nonexistent Characters on 2741 Keyboards 



EBCDIC 
Character 



. APL 
Keyboard 



SelectrJc 
Keyboard 



EBCD . 
Keyboard 



% 

4 
» 

& 

»■ ■ 



p 
c 
a 
V 
o 

n 
u 



, (upper case) 
. (upper case) 

V 

(degree) 
± 
# 



@ 
•i 

I 

& 
$ 



@ 
H 

I 
& 
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APPENDIX I. SPI4JL-FILL FEATURE 



The SPILL-FILL feature allows saving of symbiont files. 
For proper control, the programs written to use this feature 
must follow these rules: 

a) FPT's must be used for CAL1,8 exactly as shown on the 
following pages. 

b) The user's SRI at the time of CAL must contain the 
code that agrees with the desired function and FPT. 

c) AO privilege is required for SPILLing end Filling of 
output files in save mode. 

d) BO privilege is required for SPILLing JCL files in 
save mode. 

e) CO privilege is required for FILLing JCL files end for 
deleting files. 

f) No concurrent output files are eligible for SPILLing or 
' FILUhg. 

g) ,. No running JOBS can be SPILLcd/FILLed. 

At this time, no log of SPILLed files is maintained by the 
system. If, after SPILLing a JCL file, theclose operation 
specifies SAVE rather than DELETE, an entry is made on 
the operator's console that shows the job ID as resubmitted. 
If Fitting a JCL file at another job step, a new SYSID is : 
assigned and returned in the user's SRI . This preserves tbe'll 
uniqueness of BATCH IDs. It is the SPILL/FILL user's — r 
responsibility to keep other users informed -or any such 
changes. . v..- 

If SPILLing in the SAVE mode and the number of ,fNF|LE/f >', 
OUTFILE slots drops too low, the user is queued for" RBBAT - 
to make more slots available. The user should be aware of 
the number of file slots available before starting. Monitor 
cell BL:IFS contains the number of available INFILE slots 
and BLrOFS contains the number of available OUTFILE 
slots. f 

When FILLing a JCL file and a slot is taken, the user's SRI 
is updated with the value of BL:IFS. When FILLing an out- 
put file and a slot is taken, the user's SRI is updated with 
BLrOFS. These values are not converted to EBCDIC. If 
insufficient slots exist, the user's SRI is set to -1, and the 
requested FILL is denied. 

On return, the user's SRI contains tfie following: 



SRI 



F F j . ■ F 


F F 


F F 


BL:IFS/BL:OFS 


NEW SYSID 



Example 


of how to SPILL: 




REFM:XX,M:ZZ 


START 


EQU $ 


* 


User Initialization Code 


SPILL1 


M.OPEN M:YY ,(.... 


SPILL2 


EQU $ 




LI, SRI C'SP' 


SPILL3 


EQU $ 




CAL 1,8 SPILLFPT 




BCS,8 BAD 


SPILL4 


M:OPEN M:XX,(DEVICE,'C2'), 




(FPARAM,FPT2),; 






SPILLS 


M:WRITE M:YY,(BUF,FPT2), 




(SIZE,56),(..... 


SPILL6 


M:READ M:XX,{BUF ,BUF2}, •„■*. 




(SIZE,512),(ABN,EOF), 
LW,R1 M:XX+4 






SLS,R1 -17 


SPILL7 


. M:WRITE M:YY,(iUF,BUF2), 




<SiZE,*l),(...... 




JV . '., SPILL6 


EOF 


r^CtClSE ^ M:XX,(... 
m$X - CSP' DEtETE 






'KfcLDfV 'C2' f ASAVE 


* 


User Termination Code . 


*," - 


Checking SRI 


# 


and Logging Wbats 


* 


Been Done 



NOFILE 



BAD 



User Code to Handle that Function 



User Code to Handle Bad FPT, insufficient 

symbiont space. 

Also If Privilege Wrong for Requested Feature 



16 



31 



SPfLLFPT 


DATA 


X'lAOOOSOO' 


OPTCON 


DATA 


X'F01808mO' 


REQP1 


DATA 


CC2« 


OPTP2 


DATA 


Cqq' 


OPTP3 


DATA 


XV 


REQP4 


DATA 


X'2' 


OPTP12 


DATA 


Cform' 


REQP13 


GEN, 16,8,8 


XV^'Ip'^X" 


OPTP21 


DATA 


X'id' 
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h -:: a 



MP •_ E ■"- ""' I L.L F'F' ; 
;=; i..j t t H •=> H N Zl '~ r " 
T' T f-i TWF ~ V M %■ 

i — i- cnp »— ' i i j * cv 



■!jc>j TO tlJ;- 
II.-' CHPI'i flBP 
• p ; m p LE FROGRFi M 

.L.6+1 if Df4E is 9031 138-2(9/78) 



FPT2 
BUF2 



BOUND 8 

RES 14 . ' ••■• 

RES 512 

OPTCON needs to be adjusted for proper 

presence bits 

REQP1,REQP4,REQP13 must be there or 

CAL1 ,8 will be error ed. 

REQPl,OPTP2,OPTP3,REQP13,OPTP21 con 
be indirect. 

Any other parameter presence bits will result 
in an error return from the CAL1 ,8. 

qq can be used to selectively SPILL files 

for specific devices. 

n is the origin of the file being 

SPILLed; indicates a local file, any 
other number indicates a remote file 
and n is the work station number. 

Ip is the low priority range 00-22 

hp is the high priority range 00-22 

00-GF are input JCL files waiting in 
■> batch queue to run priority 0-F. 

11-20 output files priority 0-F 

21 message files 

22 NGTL control files, 
id is the SYSID of the Tile, v 

m 4 means remove fifeffjrbrri RBBATs 

1 means temporffljly^move file 

from RBBAfs jiwffllMrje while 
making copy of it£5w)£j« 



* form If form name needs to be specified. ' 

Example of how to FILL; that is, return what was SPIL.Led: 
REF M:XX,M:YY 



START 



FILL1 
FILL2 



FILL3 

FILL4 
FILL5 



EQU 



$ 



User Initialization Code for Record Keeping 



MrOPEN 
M:READ 

LI, SRI 

CAL1,8 

BCS,8 

MrOPEN 

M:READ 



♦ r 



LW,1 
SLS,1 

G S E L. E r C T 



M:XX,( 

M:XX,(BUF,FPT3), 

(SIZE,56),(... 

CFP 

FPT3 

BAD 

M:YY,(DEVICE,'C2 , ) 

M:XX,(BUF,INBUF), 

(SIZE, 512), (ABN, EOF), 

(... 

M:XX + 4 

-17 



!'£•/ ICE NRME (l,E« * C-Kl \Jr !• L P > > 
I R V 1 E i U ;~ E THE N U M ERIC £ E ' ■•' T C E N '<■ 

90 3 f " ':■■' ' 1 "" ' * "■■:'"' 9 1 '"* > > If npTP£ := 0t T<~t\ 

IE DDME (SYHBIDN'T FILE:" FDF RLL 



FILL6 



EOF 



FPT3 

* 

INBUF 
BAD 



User Code to Check for Multiple File 

M.-WRITE M:XX,(BUF, INBUF), 

(SIZE,*1),(... 
B . FILLS 

M:CLOSE M:YY,{... 

LI, SRI CFI' 

M:LDEV 'C2',ASAVE 

user code to check SRI 
and perform required functions 
based on its contents; i.e., new SYSID'. 

RES 14 

FPT not optional, all parameters must remain 
as they were from SPILL operations. 
RES 512 



EQU 
user 



$ 

code 



M:LDEV (SPILL) FPT Options 



WordO 




7 8 



15 16 



31 



X'lA* 



1.0 I 1 3 I* 5 4 7 ll • 10 llllj li U isll» 17 1» l«l» 21 22 23lj4 !S 24 2?!?6 V 30 3 



Word 1 






















































P 


P 
2 


P 
3 


P 

4 


| 












ck 
















3. 



























i 


> 


J 


4 J 


4 


7 


I 


» 


10 


Ml 12 


U 


14 


IS 


16 


i; 


it 


i»i» 


21 


22 


23 24 


25 


26 


1! 


28 


r> 


30 


31 



stream-id (PI) 



,Stream-?d 



1 J, 1 \* i 4' r'l* » 10 111 IJ 13 14 13114 17 I* 1»I20 Ji 17 2sl 2* 25 26 27 1 2S 2» 

option DEV (P2) 



L 



j Device type mnemonic 
or RBID Device Code 



6 1 ] "3 I 4 S * 7 I » t 10 III IJ 13 14 lj! 1617 \i l»l» 21 22 23l24 25 14 27lse 2» 



option WSN (P3) 



: RBID of WSN 



1 I 3I4 3 6 7 I • * 10 Illl2 13 14 15114 17 It 1*1 20 JI 22 23124 35 26 27 1 2« 



option SPILL (P4) 








'•2 
1 





1 I J U J t 7 11 * 10 III II 13 14 


15)14 17 II I»lj0 21 2J 23l24 25 36 27 1 2B 29 30 JI 



option FORM (PI 2) 



Form Name 



i I } i\l l 4 > l i I Ifl h l iMi U Ii l i6 \i \t \i \ ib i; ii Mi* ii h <> \ U * 30 3 



option PRIO (P13) 



! low priority ! high priority 



1 1 3 I 4 J t J I I » 10 lit 12 >J 14 <}l 14 17 14 1*1 20 21 22 23! 34 25 26 27 1 241 T» 30 31 



j-ps ;d F '.-■' I C E E EN 
iMBER 

" N ND DEi/'ICE SELECTION 
T: E !.-■' I C E S F F E £ U M P E £ .' ! * 
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option SYSID (P21). 



rtr-rr-rt 



Syiid 



t 16 I? IB If I J 



I ; J.T* V 6 7 Tg 9 10 llTlJ 13 U 151 16 I? IB 19120 II 22 711 M 2J'26 27128 29 » 31 



word 6 (P8) 








ft* 


JDEorO 


1 2 3 1 4 5. ♦ >U 9 


10 1 


rill 13 14 ISII6 " 18 191 70 21 22 13 


14 25 26 IT 1 73 2* 30 -J! 



MrLDEV (FILL) FPT - As FPARAMs 





VIA 


1 






— . — 1 t 







* 


4 i 2 i!< s » 7 1« « io mo 13 i4 iiii6 '7 it 19I26 Ji J! JJli* ii 1V2H2! X 35 5" 
word 1 


1 1 


1 


1 io 

1 








1 


\ 





1 


1 


11100000! 00000000000 


1 2 2 1 < 5 6 7 

word 2 (PI) 


8 » 10 II 


12 13 14 15 


16 17 18 19 


20 21 22 23124 25 26 27128 29 30 31 


■ 


Stream Name 


1 2 J 1 4 J 6 7 ! 6 9 10 111 12 i"i U ill 

word 3 (P2) 


16 17 1* 19! 20 21 21 llll* 15 26 27i28 29 X 31 




Device type mnemonic 
or RBID Device Code 


S, 1 2 } 1 4 5 6 7 1 8 » 10 lit 12 11 14 "j 

word 4 (P3) , 


16 17 It Ifl20 21 22 13J24 25 26 27 lit 29 30 31 


-. ' 1. 

i ' 


RBID 
orO 


4 i i J t « 5 « 7 it f Io htu li u 1st it i7 la l^tjo >l 22 ii 

word 5 (P4) 


24 }i 24 iM'Ji 29 ii 3 


. ' *'*■.. ■*•';.. ' '. 


3 


1 


2 


Jl4 


J 


* 


7 


I.« 


* 


10 


i* 


111 


13 


14 


15 


lie 


»7 


II 


19 


Ik 


H 22 22 


124 25 26 17128 29 


30 31 



word 7 (P9) 



Copies 



I 2 114 5 6 7 I t 9 10 11112 13 14 ISI16 17 18 I9l» 21 22 23'l4 25 26 2'I2* 79 

word 8 (PIT) 



RBBAT 
« i s j rr $ » > 


Reserved 

8 9 16 lltli 1} U lit* 1* IB rttio 21 » i3 


Device 
Code 

14 15 26 2?l 28 r> 10 31 



word 9 (PI 2) 



Form name or 



i 2 1 I 4 5 6 7 I 8 5 10 111 12 13 14 15 1 16 17 18 19 1 20 21 22 23*24 25 16 27 ! 78 29 30 3 



word 10 (P13) 



Priority 



I 2 3t4 5 6 7 t * 9 10 111 I? 13 14 I5ll6 17 It I9l» 21 21 13ll4 25 26 27 1« 29 30 31 



word 11 (PI 4) 






















Reserved 


1 1 3 (4 5 6 7 


nr 


9 


10 11 


•1 


13 14 151 16 17 It 


19 1» 2,1 


21 23 1 


24 25 26 27 


28 29 


30 31 



word 12 (PI 5) 



Reserved * 



t I 2 l l i i 6 f I t * 16 ti l l! \i 14 li t 16 I? ti l< ! 70 71 » h i 14 25 26 2> l l6 29 to 3 

word 13 (P21) .../.^. 



Granuje .£oGf(t If 



r "-* jt4 a ':* ill t 10 iil 12 13 u u 



Sysid 



16 17 It 19I20 21 22 23 1 24 15 16 27 1 2! 7a 
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MDEX 



Note: For each entry in this index, the number of the most significant page is listed first, Any pages-. thereafter ore listed in 
numerical sequence. 



* command, ANLZ, 46 

? command, DRSP, 110 

I command, ANLZ, 46 

560 cluster/unit matrix, 156 

560 Remote Assist Station, 175,23 

2741 terminal, substitutions for nonexistent characters, 223 



ANSC1I, 216,214,221 

AP, 6 

APL, 8 

application processors, 11 

armed interrupt, 126 

Assembly Program (see AP) 

automatic recovery, 23 



A Programming Language, 8 
active interrupt* 126 
ALL. command, ANLZ, 43 
•Analyze (see ANLZ) 
ANLZ, 42, K), 23 
tjatch mode, 42 

command summary, 59, 58 
ANLZ, "commands, 42 

*, 46' 

I, 46 . 

ALL, 43 

BF, 47 

CLOSE, 48 

COMPARE, 46 

DELTA, 47 

DISPLAY, 43 

DUMP, 48 

END, 49 

HELP, 48 

INPUT, 43 

IS, 48 

LINE FEED, 46 

loc, 43 

loc =value, 46" 

loci, loc2, 46 

LP, 47 

MAP, 46 

MONITOR, 46 

NODELTA, 47 

PRINT, 47 

ROWS, 47 

RUN, 43 

SEARCH, 47 

SMASK, 47 

SPY, 48 

SYMBOLS, 48 

SYMBOL/, 48 

UC, 47 

UNMAP, 46 
ANLZ, ghost mode, 42 
ANLZ, messages, 58 
ANLZ, on-line mode, 42 
ANLZ, output, 49 
ANS COBOL (see COBOL) 
ANS labeled tape, xi 



BASIC, 6 

Batch (processor), 11 

batch job, xi 

batch processing, 1 

BF command, ANLZ, 47 

binary input, xi 

booting, 24,37 

from disk, 40 
bootstrap I/O error recovery, 40 
bootstrap operations (see booting) 



CCI, 99,4 

character sets, 214 

CIRC, 12 . * 

cleared interrupt, 126 

CLIS command, ELLA, 68 

CLOSE command, ANLZ, 48 

cluster/unit matrix, 156 

COBOL, 7 

COBOL On- Line Debugger, 10 

codes and correspondences, 214 

command processor programming, 101 

command processors, 3 

command summaries, ANLZ, 59,58 

DRSP, 113,110 

ELLA, 91,90 

reconfiguration and partitioning, 29,24 
command syntax notation, x 
commands, control, xi 
COMPARE commond, ANLZ, 46 
compressed language, 213 
concatenation, xi 

conditional patch control commands, 35 
conflicting reference, xi 
Control (processor), 4 
control codes, 214 
Control Command Interpreter, 94,4 
control commands, xi 
control message, xi 
cooperative, xi 



Index 
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No to : For each entry In this index, the number of- the most significant page ts listed first. Any pages thereafter are listed in 
numerical sequence. 



CP-V operating system, 3 
crash analysis (see ANLZ) 



Da fa Control Block, 96, xi 
DCB, 96, xi 

diagnostic, 122,115, 120 
DDCB, 122,115,120.1 
DEFCOM, 10 
DELETE command, DRSP, 109 

GENMD, 34 
Delta, 9 

DELTA command, ANLZ, 47 
Delta format patches, 24 
DEV command, ELLA, 84 
DEVDMP, 5 

device designation codes, 156 
device names, 156 
Device Save/Restore processor, 5 
device type codes, 156 
diagnostic DCB, 122,115 

diagnostics (see on-line peripheral diagnostic facilities) 
disabled interrupt, 126 
disarmed interrupt/ 126 
DISP command, ELLA, 81 
DISPL command, ELLA, 87 
DISPLAY command, 

ANLZ,;43 

PPS, 145~ 
DRSP, 106/11 

DRSP, command "summary, 1 T3, 1 10 
DRSP, commands, 

?, 110 

DELETE, 109 

END, 110 

ENTER, 106 

LIST, 109 

L1STALL, 109 

REPLACE, 109 
DRSP, error messages, 111,110 
DRSP, limitations and restrictions, 110 
DUMP command, ANLZ, 48 

Dynamic Replacement of Shared Processors (see DRSP) 
DYNRESDF command, PPS, 146 



EASY, 4 

EBCDIC, 215,214 

Edit (processor), 10 

EDMS, 11 

ELLA, 65,11,22 

ELLA, command summary, 91,90 

ELLA, commands, 

CLIS, 68 

DEV, 84 



DISP, 81 

DSPL, 87 

END, 62 

MOD, 84 

RSET, 82 

SET, 65 

SLIS, 77 

SUM, 81 

TIME, 83 

TYPE, 84 
ELLA, 

error log entry headings, 70 

error log entry types, 77 

input/output assignments, 65 

input/output characteristics, 67 

interrupting execution, 68 

messages, 90 

predefined tasks, 87 

RBrFLAGS structure, 75 

starting execution, 65 
enabled interrupt, 126 
END command, ANLZ, 49 

DRSP, 110 

ELLA, 82 

PPS, 147 
:END command (boot-time), 29 
ENTER command, DRSJ^JOS' 
ERR:FIL, 65,22 '] ' "" 

ERRFILEfiie, 178,65 
ERRFJtE file formats, 178 

bad granule release, J88 

configuration record, 187 

device error, 184 • 

duplicate entries,' 187 

enqueue table overflow, 196 

errlog record length error, 182 

file inconsistency error, 186 

hardware errors, 192 

I/O activity count, 192 

illegal entry type, 183 

incorrect time, 183 

instruction exception, 194 

lost entry indicator, 187 

memory fault interrupt, 183 

memory parity secondary record, 195 • 

MFI primary record, 194 

operator message, 192 

partitioned resource, 196 

PFI primary record, 194 

power on, 187 

processor fault interrupt, 183 

read error, 182 

remote processing error, 188 

returned resource, 196 

secondary records for disk pack, RAD, and tape, 185 

Sigma 6/7 memory parity secondary record, 195 

SIO failure, 183 

software-detected symbiont inconsistencies, 186 

system identification, 187 

system startup, 185 
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Note: For ecch entry in this index, the number of the most significant page U listed- first .'. Any pages thereafter 'are fisted in 
numericoi sequence. 



time out, 184 

time stamp, 188 

unexpected interrupt, 184 

watchdog timer, 193 

Xerox 560 memory parity secondary record, 195 

Xerox 560 secondary record for poll information, 195 
ERRMSG file, 63 

error detection and recover)', 22, 23 
error log file (see ERRFILE) 
Error Log Listing program (see ELLA) 
error log, 

reading, 92 

writing, 92 
error message file, 63 
error messages (see messages) 
error record terminology, 178 
execution control processors, 9 
Extended Data Management System, 11 
Extended FORTRAN IV, 5 
external reference, xi 



GET command, Ff'S, 145 

ghost job, xi 

ghost job, initiating, 92 

global symbol, xi 

:GO command (boot-time), 27 

GO file, xi 

GPDS, 12 

Granule Accounting Cleanup processor, 5 

granule, xi 



hardware-error diagnostic CALs, 91 

initiate ghost job, 92 

read error log, 92 

write error log, 92 
HELP command, ANLZ, 48 



FDP, 9 

f 1 1 e ma i nte na nee process^!!,?; 23 

files, 

extension, 101, xi 

identification, 98 t ,; 

shared, 101 
FILL (processor), 4 
Fix (processor), 4 
fixed monitor locations, 44 
FLAG, 7 
FORTRAN, 5 

FORTRAN Debug Package, 9 
FORTRAN libraries, 98,14 
FORTRAN Load and Go, 7 
FPT, xi 

FREE command, PPS, 145 
FRES, 5 
FSAVE, 5 
function parameter table, xi 



I 

I/O scheduling, 18 

1CB, 126 

initialization and start-up routines, -24 

INPUT command, ANLZ, 43 

interrupt connection and control services, regl-time, 126 

interrupt, control block, 12$ 

interrupt label* 126 - ' v 

IOP designatior? codes, 156 

IS command/ ANLZ, 48 



JIT, 95, xi 
job step, xi 



GAC, 5 

:GENDCB command, 34 
General Purpose Discrete Simulator, 12 
GENMD, 
commands, 
DELETE, 34 
GENMD, 34 
LIST, 34 
error messages, 36, 35 
patches, 35 
GENMD command, GENMD, 34 



key, xi 
key-in, xi 



Label, 5 

language processors, 5, xi 

libraries, 104 

FORTRAN, 98, 14 

public, 104,xii 

system, xiii 
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No he.- For each entry ,in this index,; the number of the most significant page is listed first. Any pages thereafter are listed in 
•/ numerical: "sequence . 



library load' module, xi 

LINE FEED command, ANLZ," 46 ' 

Link (processor), 9 

linking loader, xi 

LIST command, 

DRSP, 109 

GENMD, 34 
list formats (transaction processing), 152 
LISTALL command, DBSP, 109 
Load (processor), 9 
load map, xi 
load module, xi 
loc command, ANLZ, 43 
loc "value command, ANLZ, 46 
locl,loc2 command, ANLZ, 46 
log-on connection, 94 
logical device, xi 
logical device stream, xi 
LOGON/LOGOFF, 3 
LP command, ANLZ, 47 
LYNX (processor), 9 
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MtBUST, 117 
M:CHKINT, 139 
MrCLOCK, 132 - 
M:COC, 143 
MrCONNECT; 127 
M:DCLOSE,,y7 
M:DDC8, 115 
M:DISCONNltT, 128 
M:DMOD # , 120 
M:DMODX,*120 
M:DOPEN, 116 
M:EXCP, 140 
M-.EXU, 136 
M:FPP, 137 
M:GDG, 138 
MrGETID, 149 
MrGJOB, 137 
M:GJOBCON, 127 
M:GPP, 137 
M.-HOLD, 131 
MrlNHIBIT, 129 
M:INTCON, 129 
MrlNTRTN, 130 
MrlNTSTAT, 131 
MrlOEX, 134 
M:LOCK, 119 
M:MAP, 120, 137 
MrMASTER, 136 
MrNEWQ, 140 
M:QFI, 130 
M:QUE, 142 
MrQUEUE, 149 
M:RDG, 138 
M:RUE, 138 
M:SIO, 119 



M:STARTIO, 134 
MrSTOPIO, 132 
Manage, 12 

MAP command, ANLZ, 46 
master system tape, 24, 25 
memory control, 96 
memory layout, 20 
memory management, 14 
messages, 

ANLZ, 58 

DRSP, 111,110 

ELLA, 90 

GENMD, 36,35 

on-line peripheral diagnostics, 114 

PASSO, 41 

reconfiguration and partitioning, 32,31 
Meta-Symbol, 6 
MOD command, ELLA, 84 
monitor, 13,xii 

MONITOR command, ANLZ, 46 
monitor DEFs (for real-time), 147 
monitor dump analysis program (see ANiZ)r 
MOS command, ELLA, 88 
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.WJpELTA command, AKLZ, «f 
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object language; 195, xfi 

object module, xii 

drrline job, xii 

on-lirie peripheral diagnostic facilities, 114,22 

abnormal codes and messages, 121, 120 

DDCB, 122,115,120 

M-.BLIST, 117 

M:DCLOSE, 117 

M:DDCB, 115 

M:DMOD # , 120 

M:DOPEN, 116 

M:LOCK, 119 

M:MAP, 120,137 

M:SIO, 119 

PSECT directive, 114 

restrictions, 1 14 
operational label, 155, xii 
output (see messages) 
overlay loader, xii 
overlay program, xii 
overlay restrictions, shared processors, 96 



page allocation for real-time, 143 
.•PART command, boot-time, 29 
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partitioning, resources, 27,29 

PAS SO, 41 ; 

PASSO, error messages, 41 

patch, xii 

patch control commands, conditional, 35 

patch deck comment cards, 37 

patch deck structure, 24 

patch deck symbol table, 26 

patch file creation, 37 

patches, Delta format, 24 

patching operations, 24 

PCL, 10 

Peripheral Conversion Language, 10 

peripheral device (see device) 

peripheral diagnostic facilities (see on-line peripheral 

diagnostic facilities) 
physicaj device, xii 

physical page allocation for real-time, 143 
Physical Page Stealer (see PPS) 
PPS, ,144 
PPS;' commands, 

DISPLAY, 145 

DYNRESDF, |46 

END, 147 . 

FREE, 145 

GET, 145 

RESDF, 146 
preventive maintenaB^iP-olS 1 
PRINT command, A^LZ^ 47 
procedures, 

M-.BLIST, 117 

MrCHKINT, 139 

M.-CLOCK, 132 

M:COC, 143 

M:CONNECT, 127 

M-.DCLOSE, 117 

M-.DDCB, 115 

M:DlSCONNECT, 128 

MrDMOD*, 120 

MrDOPEN, 116 

M:EXCP, 140 

M:EXU, 136 

M:FPP, 137 

M:GDG, 138 

M:GETID, 149 

M.-GJOB, 137 

MrGJOBCON, 127 

M:GPP, 137 

M.-HOLD, 131 

M:1NHIBIT, 129 

MrlNTCON, 129 

M:INTRTN, 130 

M:INTSTAT, 131 

MrlOEX, 134 

MrLOCK, 119 

M:MAP, 120,137 

MrMASTER, 136 

M:NEWQ, 140. 

M.QFI, 130 

M:QUE, 142 



M:QUEUE; 149 

M:RDG, .138 

M:RUE, 138 , 

M:SIO, 119 

M:SLAVE, 136 

MrSTARTIO, 134 

MiSTOPIO, 132 

real-time, 126 
processor management, 19 
processor" privileges, 93 
processors, 

application, 11 

command, 3 

execution control, 9 

language, 5, xi 

service, 10 

shared processor facilities, 106 

system management, 4 

user, 13 
program product, xii 
prompt character, xii 
protective mode, xii 
PSECT directive, 114,137 
public library, 104, xii 
public programs, 93 



RATES, 4 

RB:FLAG, 189 

read error log, 92 ' 

real-time facilities,. 126,2 

clock service,' 132 

device preemption services, 132 

direct I/O services, 134 
; dynamic physical page allocation, 143 

interrupt connection and control services, 126 

lock in core service, 131 

miscellaneous services, 137 
real-time libraries, 106, 104 
reconfiguration and partitioning commands, 27 

:END, 29 

:GO, 27 

:PART, 29 

rREMOVE, 28 

:SAVE, 28 

:TYPE, 28 
reconfiguration and partitioning commands summary, 27, 24 
reconfiguration and partitioning messages, 32,31 
recovery, 22,23 
reentrant, xii 
relative allocation, xii 
relocatable object module (ROM), xii 
Remote Assist Station, 175,22 
remote diagnostic assistance, 175, 22 
remote processing, 2,xiii 
:REMOVE command (boot-time), 28 
REPLACE command, DRSP, 109 
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Report. Program Generator, 8 

RF.SDF command, PPS, 146 

RESDF memory GAL, 147 

resident program, xii 

response time, xii 

ROM, xii 

ROV/S command, ANLZ, 47 

RPG, 8 

RSET command, ELLA, 82 

RUN command, ANLZ, 43 



rSAVE command (boot-time), 28 
scheduler, xii 
scheduler inputs, 15 
scheduler operation, 16 
scheduler output, 16 
scheduler status queues, 17 
scheduling, 14 

screech codes (see software check codes) 
SEARCH command, ANLZ, 47 
Secondary storage, xii 
;, **mi-protective mode, xii 
service processors, 10 
SET command, ELLA, 65 
shored file use, 101 
shared processor, xii 
shared processor fdci lilies, 93 
shared processor maintenance, 106 
shared processor programming, 94 
shared programs, 93 . 
Show processor, 11 
Simulation Language, S 
SL-1, 8 

SLIS command, ELLA, 77 
SMASK command, ANLZ, 47 
software check codes, 157 
Sort /Merge, 11 
source language, xii 
special shared processor, xii 
specific allocation, xii 
SPILL-FILL, 224 
SPY command, ANLZ, 48 
standard object language, 197 
start-up, 24 
static core module, xiii 
STATS, 5 
status queues, 17 
stream-id, xiii 
SUM command, ELLA, 81 
Summary (processor), 5 
Super (processor), 4 
swap hardware organization, 18 
swap-in, swap-out queues, 18 
symbiont, xiii 

Symbol Control Processor, 10 
symbol-code correspondences, 214 
symbolic input, xiii 



symbolic name, xiii 

SYMBOLS command, ANLZ, 48 

SYMBOL/command, ANLZ, 48 

symbols, graphic, 214 

SYMCON, 10 

SYSCON, 5 

SYSGEN, 10,xii? 

SYSTEM DIAG, 115 

system error log file (see ERRF1LE) 

system generation, 10, xiii 

system integrity, 20 

system library, xiii 

system loading, 24 

system management processors, 4 

system programming facilities, 2 

System Queue Manager, 148 

system register, xiii 

SYSTEM RTPROCS, 126 

SYSTEM SIG 7, 115 

SYSTEM SIG9, 115 

system start-up and initialization, ^4 

system tape format, 24,25 



tape, master system, 24, 25 

task control block (TC&f, xiii 

TEL, '4 

TEL scan, 98 

Terminal Executive Language, 4 

terminal I/O, 99 

TIME command, ELLA, 83 

time-sharing, 1 

transaction processing, 2 

transaction processing facilities, 148 
list formats, 152 
M:GETID, 149 
MrQUEUE FPTs, 150 
M:QUEUE procedure format, 149 
M:QUEUE procedure output, 153 
System Queue Manager, 148 

TYPE command, ELLA, 84 

:TYPE command (boot-time), 28 



u 

UC command, ANLZ, 47 
UNMAP command, ANLZ, 46 
unsatisfied reference, xiii 
user processors, 13 
user status queues, 17 
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virtual memory, special processors, 44 
VOLINIT, 5 

w 

waiting interrupt, 126 
write error log, 92 



Xerox 560 cluster/unit matrix, 156 
Xerox 560 Remote Assist Station, 175,23 
Xerox standard compressed language, 213 
Xerox standard object language, 195 
Xerox standard symbols, codes, and 
correspondences, 214 
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